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废话 少 说 ， 开 始 吧 | 


从 Python 到 Django 入 门 教程 


Python 是 一 门面 向 对 象 的 编程 语言 ， 它 相对 于 其 他 语言 ， 更 加 易学 、 易 读 ， 非 常 适合 快速 开 
发 。Python 具 有 简单 、 匈 学、 免费、 开源 、 可 移植 、 可 扩展 、 可 获 入 、 面 向 对 象 等 优点 ， 它 
的 面向 对 象 甚 至 比 java 和 C#.net 更 彻底 。 作 为 一 种 通用 语言 ，Python 几 乎 可 以 用 在 任何 领域 和 
场合 ， 角 色 几 乎 是 无 限 的 。Python 在 软件 质量 控制 、 提 升 开发 效率 、 可 移植 性 、 组 件 集成 、 
丰富 库 支 持 等 各 个 方面 均 处 于 先进 地 位 。 学 习 编 程 语言 ， 除 了 拿 好 现 有 的 饭碗 ， 还 要 选择 学 
习 业 内 目前 最 先进 、 最 热门 、 将 来 应 用 最 广泛 、 最 有 前 途 和 前 景 的 编程 语言 。 有 人 预言 ， 
Python 会 成 为 继 C++ 和 Java 之 后 的 第 三 个 主流 编程 语言 。 

Django 是 一 个 开放 源 代码 的 Web 应 用 框架 ， 由 Python 写 成 。 采 用 了 MVC 的 软件 设计 模式 ， 即 
模型 M， 视 图 V 和 控制 器 C。 它 最 初 是 被 开发 来 用 于 管理 劳伦斯 出 版 集团 旗下 的 一 些 以 新 闻 内 
容 为 主 的 网 站 的 。 并 于 2005 年 7 月 在 BSD 许 可 证 下 发 布 。 这 套 框 架 是 以 比利时 的 吉普 赛 亩 士 吉 
他 手 Django Reinhardt 来 命名 的 。 


Django 的 主要 目标 是 使 得 开发 复杂 的 、 数 据 库 驱 动 的 网 站 变 得 简单 。Dijango 注 重组 件 的 重用 
性 和 "可 插 拔 性 ”， 敏 捷 开 发 和 DRY 法 则 (Don't Repeat Yourself) 。 在 Dijango 中 Python 被 普遍 
使 用 ， 甚 至 包括 配置 文件 和 数据 模型 。 


在 Python 各 种 web 框 架 中 ，Django 的 文档 最 完善 、 市 场 占有 率 最 高 、 招 聘 职位 最 多 ! 


本 书 整理 Python 和 Dijango 的 入 门 教程 ， 给 零 起 点 的 程序 员 一 个 完整 的 学 习 路 径 : 


Python 3.6--->Django 1.11 


开发 环境 


本 文 的 范例 基于 Visual Studio Code 编 辑 器 完成 的 。 因 此 ， 你 需要 准备 以 下 这 些 软件 : 
e VS Code 编 辑 器 ， 还 需要 安装 Python 扩展 。 


。 Python3 的 安装 文件 ， 根 据 你 自己 的 操作 系统 安装 ，" 下 一 步 & 下 一 步 "就 能 搞定， 无 需 多 


说 。 


e 用 virtualenv 搭 建 Diango 的 开发 环境 ， 后 文 会 详细 描述 。 


开始 学 习 


根据 自己 的 情况 选择 从 哪里 开始 学 习 ， 如 果 你 已 经 有 了 一 定 的 基础 ， 你 可 以 选择 跳 过 某 些 章 
节 ， 对 于 大 多 数 初学 者 来 讲 ， 学 习 的 路 径 如 下 : 


1. 搭建 Python 开 发 环境 
2. 简明 Python 教程 


3. Django step by step 


本 书 托管 在 GitHub ， 如 果 有 问题 请 在 线 提交 。 


搭建 Python 开发 环境 


安装 Python 
Python 的 开发 环境 是 比较 简单 的 ， 到 去 下 载 对 应 的 


Python3 安 装 包 ， 安 装 的 时 候 义 选 上 修改 PATH 的 选项 ， 然 后 完成 安装 就 是 了 。 本 文 使 用 的 是 
Python 3.6.3 ° 


调 出 你 的 终端 (cmd) ， 输 入 


python 


如 果 出 现下 面 的 提示 ， 那 么 说 明 你 已 经 安装 成 功 了 。 


5. 2:4def2a2901a5, Jun 25 2016, 22:18:55) [MSC v. 1900 64 bit (AM 


“copyright, “credits” or “license” for more information. 





Python 环境 搭 好 之 后 首先 要 做 的 就 是 这 个 


print('hello world!') 


REM | 


Sits a 
 Rvirtualenv 

virtualenv 可 以 建立 多 个 独立 的 虚拟 环境 ， 各 个 环境 中 拥有 自己 的 python 解 释 器 和 各 自 的 
package 包 ， 互 不 影响 。 使 用 Python 自 带 的 pip 工 具 可 以 很 方便 的 安装 、 趣 载 和 管理 Python 的 


é, 。 


pip install virtualenv 


pip 和 virtualenv 可 以 很 好 的 协同 工作 ， 同 时 使 用 这 两 个 工具 非常 方便 。 用 virtualenv env1 就 可 
以 创建 一 个 名 为 env1 的 虚拟 环境 了 ， 进 入 这 个 虚拟 环境 后 ， 再 使 用 pip install 安 装 其 它 的 
package 就 只 会 安装 到 这 个 虚拟 环境 里 ， 不 会 影响 其 它 虚 拟 环 境 或 系统 环境 。 接 下 来 我 们 要 
用 这 个 工具 创建 我 们 自己 的 开发 环境 。 

mole ny 

x x Django1.11 


为 了 能 够 使 用 Django 的 命令 行 ， 我 们 把 Django 安 装 到 系统 的 环境 中 ， 在 命令 行 中 输入 : 


pip instal django 


创建 第 一 个 Django 项 目 


为 了 能 够 统一 的 管理 工程 的 代码 等 信息 ， 我 们 将 工程 代码 和 virtualenv 环 境 都 放 在 同一 个 目录 
中 ， 这 样 无 论 这 个 目录 拷贝 到 哪里 ， 都 可 以 直接 加 载 环 境 之 后 开始 运行 ， 首 先 输入 下 面 的 命 
令 创 建 第 一 个 django 项 目 : 


C:\>django-admin startproject helloworld 
C:\>cd helloworld 


然后 我 们 在 helloworld 目 录 下 面 创建 一 个 venv 的 目录 ， 保 存 这 个 Django 项 目的 虚拟 环境 ， 之 后 
我 们 在 这 个 虚拟 环境 中 安装 Django1.10 


C:\helloworld\>virtualenv venv 
C:\helloworld\>venv\scripts\activate 
(venv) C:\helloworld\>pip install django 
(venv) C:\helloworld\> 


这 个 时 候 你 应 该 可 以 看 到 提示 符 前 面 增加 了 “(venv) ”的 字样 ， 如 下 所 示 : 


C:\helloworld>., 





这 个 时 候 你 的 virtualenv 就 已 经 激活 了 ， 如 果 你 再 输入 python 命令 : 的 时 候 ， 就 会 使 用 这 个 
虚拟 环境 下 面 的 Python。 请 注意 ， 下 面 的 教程 我 么 都 是 在 这 个 环境 下 面 运行 的 。 


下 面 让 我 们 运行 一 下 我 们 的 第 一 个 Django 项 目 。 如 果 你 运行 了 python 命令 ， 输 入 exit() 退 
出 。 在 命令 行 下 面 输入 : 


(venv) C:\helloworld\>python manage.py runserver 


然后 使 用 浏览 器 打开 这 个 地 址 就 可 以 看 到 一 个 欢迎 页 面 了 。 


It worked! 


Congratulations on your first Django-powered page. 


Of course, you haven’ t actually done any work yet. Next, start your first app by rumning python manage. py startapp [app_label]. 


You’ re seeing this message because you have DEBUG = True in your Django settings file and you haven't configured any URLs. Get to work! 





在 命令 行 下 面 使 用 ctrltc 可 以 退出 这 个 Django 项 目 。 


安装 Visual Studio Code 作 为 Python IDE 





访问 下 载 Visual Studio Code (简称 VS Code) 客户 端 ， 然 后 安 
装 。 打 开 后 会 看 到 如 下 的 界面 。 


> Visual Studio Code - 口 x | 
帮助 (H) 





文件 (F) 编辑 (E) BBV) 转 到 (G) 





点 击 箭头 所 指 的 扩展 按钮 ， 输 入 @popular ， 就 会 显示 最 流行 的 扩展 清单 ， 选 择 Python 扩 展 


www.ts - node-express-ts - Visual Studio Code a 口 x 
File Edit View Goto Help 
EXTENSIONS 
t app from = 


t debugModule = require( 
C# ere ort http = require( uF 


( C# | C# for Visual Studio Code (p... 
instali const debug = debugModule( 


E Python k 
r (multi-t.. s 
Sl 一 - const port = normalizePort(process.env.PORT || 


app.set( z port); 


@popular 


Debugger for Chrome 


CSSImportRule 


upportsRule 


Install 


export 


v Debug your JavaScript code... 
a 


C/C++ k* ə exports 
Complete C/C++ language ... = import 
Install ð importSc 


= 
Go k 5 
Rich Go language support f... ee 
Install # port const port: number string | boolean 


ESLint * 
ES Integrates ESLint into VS Ca... 
Install 


function normalizePort(val: any) 
let port = parseInt(val, 10); 





由 于 我 们 的 virtualenv 目 录 会 放 到 Python 项 目的 venv 子 目录 下 ， 所 以 我 们 要 对 Python 扩展 进行 
一 点 设置 。 在 VS Code 菜 单 中 选择 文件"->" 首 选项 "->“ 用 户 设 置 "， 就 会 打开 用 户 设置 的 文 
件 settings.json ， 输 入 如 下 信息 指定 我 们 的 Python 环境 路 径 : 


"python.pythonPath": "${workspaceRoot}/venv/scripts/python.exe", 


使 用 VS Code 打 开 helloworld 
在 helloworld 目 录 下 输入 : 


(venv) C:\helloworld\>code . 


即 可 使 用 VS Code 打 开 helloworld 工 程 。VS Code 没 有 工程 描述 文件 ， 一 个 目录 就 是 一 个 工 
程 ， 后 面 的 例子 我 们 都 用 这 个 开发 工具 完成 。 


完结 | 


搭建 Python 开发 环境 
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简明 Python 教程 
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输入 /输出 


简明 Python 教程 
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继续 阅读 简介 


A Byte of Python 


«A Byte of Python》 有 是 一 本 介绍 用 Python 语言 编写 程序 的 免费 书 。 它 为 Python 初学 者 提供 指 
导 或 指南 。 如 果 你 对 计算 机 的 知识 仅 限于 知道 如 何 保存 文本 文件 ， 那 么 这 本 书 非常 适合 你 。 


使 用 Python 3 完成 


本 书 介绍 了 如 何 使 用 Python 3 进行 编程 。 如 果 你 仍然 使 用 Python 2， 本 文 经 过 改写 后 也 可 以 作 
为 Python 2 的 一 本 指南 。 


《A Byte of Python》 的 读者 对 象 ? 


下 面 是 一 些 人 对 本 书 的 评价 : 
这 是 我 见 到 的 最 好 的 初学 者 指南 ! 感谢 你 的 努力 。 -- Walt Michalik 


你 做 了 我 在 网 上 发 现 的 最 好 的 Python 指南 ， 伟 大 的 工作 ， 谢 谢 ! -- Joshua Robin 
(mailto:joshrob@poczta.onet.pl) 


为 初学 者 做 了 Python 编程 的 草 越 介绍 。-- Shan Rajasekaran 

Python 初学 者 最 好 的 入 门 指南 。 -- Nickson Kaigi 

这 本 指南 的 每 一 页 都 让 我 念 发 爱 上 这 门 编程 语言 。-- Herbert Feutl 

Python 初 学 者 的 一 本 完美 的 入 门 教程 ， 为 你 打开 Python 的 神秘 之 门 。-- Dilip 


我 正在 全 神 贯 注 于 我 的 工作 ， 然 后 发 现 了 这 本 "A Byte of Python"， 一 本 非常 棒 的 入 门 指 
南 ， 有 着 非常 棒 的 范例 。 -- Biologist John 

最 近 我 开始 阅读 a Byte of python。 非 常 棒 的 一 部 教程 。 我 推荐 给 所 有 的 Python 程序 员 。 
-- Mangesh 

我 正在 阅读 Swaroop 写 的 《A Byte of Python》, 我 觉得 对 于 初学 者 来 说 这 是 最 好 的 入 门 指 
南 ， 对 于 有 经 验 的 开发 者 也 很 有 帮助 。 -- Apostolos 

很 喜欢 阅读 Swaroop 写 的 《A Byte Of Python》， 这 是 我 最 喜欢 的 一 本 书 了 。 -- Yuvraj 
Sharma 

感谢 你 写 了 这 本 《A Byte Of Python》。 我 刚 开 始 通过 它 学 习 编程 ， 大 概 两 天 后 就 可 以 写 
一 些 简单 的 小 游戏 了 。 你 的 这 本 指南 非常 棒 ， 我 想 让 你 知道 他 很 有 价值 。-- Franklin 


我 来 自 印 度 Dayanandasagar 工 程 学 院 。 首 先 我 想 说 "The byte of python" 对 于 像 我 这 样 的 
初学 者 来 说 丨 是 一 本 不 错 的 入 门 指南 。 这 本 书 讲述 概念 非常 清晰 ， 还 附带 有 很 多 的 小 范 
例 帮 助 我 学 习 Python 语 言 。 太 感谢 了 ! -- Madhura 


我 是 一 名 18 岁 的 在 校 学 生 ， 目 前 在 爱尔兰 的 大 学 学 习 计 算 机 。 我 非常 感谢 您 写 了 这 本 "A 
Byte of Python"， 我 已 经 学 习 过 3 门 编程 语言 - C, Java and Javascript, 由 于 你 写 的 这 本 

非常 棒 的 入 门 教 程 ， 使 得 Python 成 为 了 我 学 习 过 的 最 简单 的 编程 语言 。 这 是 我 读 过 的 最 

好 的 编程 语言 入 门 教材 之 一 。 感 谢 你 ， 希 望 你 继续 这 项 伟大 的 工作 。 -- Matt 


“> RRA S KEK Fe > KY Pavel 最近， 我 读 了 你 的 《A Byte of Python) > R 
认为 它 是 极 好 的 由 :)。 从 例子 中 我 学 到 了 很 多 ， 你 的 书 对 像 我 这 样 的 初学 者 有 很 大 帮助 .… 
-- Pavel Simo 


我 来 自 中 国 ， 是 一 名 在 校生 。 我 看 完了 你 的 这 本 《Abyte of Python) > SHAT! 这 
本 书 如 此 之 浅显 钨 懂 ， 非 常 适合 于 初学 者 。 我 之 前 对 于 Java 和 云 计 算 非 常 感 兴 趣 ， 经 常 
在 服务 器 端 进行 编程 ， 现 在 我 觉得 Python 对 于 我 这 样 的 情况 来 说 非常 适合 。 看 完 你 的 书 
之 后 ， 我 觉得 应 该 马上 开始 Python 语言 编程 的 实践 。 我 的 英语 不 太 好 ， 写 这 封 邮 件 只 想 
感谢 你 的 辛勤 工作 。-- Roy Lau 


我 读 完 了 《A Byte of Python》， 我 想 我 趴 的 应 该 感谢 你 ， 当 我 读 到 最 后 ， 我 感到 非常 难 
过 ， 因 为 我 不 得 不 再 回 到 无 趣 的、 乏味 的 学 习 笔 记 等 中 去 。 不 论 如 何 ， 作 为 Python 学 习 
手册 ， 我 欣赏 你 的 书 。 Samuel Young 


亲爱 的 Swaroop， 我 正 跟着 一 个 对 教学 没 兴趣 的 老师 上 课 。 我 们 使 用 的 是 O'Reilly 的 
《Python 学 习 手 册 (第 二 版 ) 》， 它 不 是 没有 任何 编程 知识 的 初学 者 学 习 的 教材 ， 而 且 
我 们 的 老师 也 应 该 以 另外 一 种 方式 教学 。 非常 感谢 您 的 书籍 ， 如 果 没 有 它 ， 我 就 不 能 学 
会 Python 和 编程 。 一 百 万 次 地 感谢 ! 您 把 知识 " 笑 开 抒 碎 "到 初学 者 能 够 理解 的 水 平 ， 这 不 
是 所 有 人 都 能 做 到 的 。-- Joseph Duarte 


我 喜欢 你 的 书 ! 这 是 最 好 的 Python 教 程 ， 非 党 有 用 的 参考 手册 ， 才 华 横 溢 ， 站 正 的 杰 
Ve | 请 继续 这 种 好 的 工作 | -- Chris-André Sommerseth 


首先 ， 我 要 感谢 你 写 了 这 本 书 。 我 想 对 于 那些 想 要 Python 初学 者 指南 的 人 来 说 这 本 书 再 
适合 不 过 了 。 我 大 概 2-3 年 前 第 一 次 听 说 这 本 书 。 当 时 我 还 没有 办 法 阅读 英文 版 本 的 书 
籍 ， 所 以 我 找到 了 一 本 中 文 翻 译 的 版 本 ， 它 带领 我 进入 了 Python 编 程 的 世界 。 现 在 ， 我 
重新 读 这 本 书 的 英文 版 。 我 不 敢 相信 我 居然 不 用 查 字 典 就 看 完了 所 有 的 章节 。 当 然 了 这 
归功 于 您 使 用 非常 浅显 易 懂 的 方式 完成 这 本 书 。-- myd7349 


我 给 你 发 邮件 ， 就 是 为 了 感谢 你 在 线 编写 的 《A Byte of Python 》。 在 偶然 发 现 你 的 书 之 
前 ， 我 已 经 尝试 学 习 Python 有 几 个 月 了 。 虽 然 我 对 pyGame 取 得 了 有 限 的 成 绩 ， 但 我 从 
来 没有 完成 过 一 个 程序 。 感谢 你 对 分 类 的 简单 化 ，Python 看 起 来 确实 是 一 个 能 够 达到 的 
目标 。 看 起 来 我 已 经 学 会 了 基础 知识 ， 并 能 够 继续 我 的 真正 目标 游戏 开发 。.… 再 一 
次 ， 非 常 感谢 你 将 如 此 结构 良好 而 且 有 用 的 编程 基础 教程 放 到 网 上 ， 它 帮助 我 彻底 理解 
了 OOP， 这 之 前 两 本 书 都 没 行 。-- Matt Gallivan 
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我 感谢 你 以 及 你 的 《A Byte of Python》， 我 发 现 这 是 学 习 Python 最 好 的 途径 。 我 现在 15 
岁 ， 住 在 埃及 ， 我 的 名 字 叫 Ahmed。Python 有 是 我 学 习 的 第 二 个 编程 语言 ， 我 在 学 校 学 习 
J Visual Basic 6， 但 我 并 不 喜欢 它 ， 可 是 我 疏 的 总 欢 学 习 Python。 我 成 功 地 编写 了 地 址 
簿 程序 。 我 打算 尝试 编写 、 阅 读 更 多 Python 程序 〈 如 果 你 有 意 给 我 推荐 一 些 有 帮助 的 源 
代码 ) 。 我 也 将 开始 学 习 Java， 如 果 你 能 告诉 我 在 哪里 可 以 找到 向 你 的 教程 一 样 好 的 
Java 教 程 ， 那 将 对 我 有 很 大 帮助 。 多 谢 。 -- Ahmed Mohammed 


初学 者 想 更 多 的 学 习 Python 编 程 的 最 好 的 资源 是 Swaroop C H 编 写 的 110 页 的 PDF 教程 
《A Byte of Python》。 这 本 书写 得 很 好 ， 跟 随 它 学 习 很 容易 ， 或 许 是 当前 可 以 得 到 的 最 
好 的 Python 入 门 教程 。-- Drew Ames 


昨天 ， 我 在 Nokia N800 上 浏览 了 《A Byte of Python》 的 大 部 分 内 容 ， 这 是 我 至 今 遇 到 的 
最 简明 扼要 的 Python 教程 ,极力 推荐 作为 学 习 Python 的 一 个 起 点 。 -- Jason Delport 


对 我 而 言 ，@swaroopch 编写 的 《A Byte of Vim》 和 《A Byte of Python》 是 最 棒 的 技术 
作品 ， 读 起 来 非常 棒 。#FeelGoodFactor -- Surendran 


《A Byte of python》 至 今 最 好 (在 回答 “ 谁 能 推荐 一 个 又 好 又 便宜 的 学 习 Python 基 础 的 
wR?” PRAŤ) -- Justin LoveTrue 


“《A Byte of Python》 非 常 有 用 ， 多 谢 :)” Chinmay 


永远 是 对 新 手 和 有 经 验 的 程序 员 都 适合 的 《A Byte of Python》 的 爱好 者 。 -- Patrick 
Harrington 


我 几 天 前 开始 通过 你 的 书 学 习 Python， 这 是 一 本 非常 好 的 书 。 写 得 如 此 之 好 ， 让 我 的 生 
活 非常 美好 。 现 在 我 已 经 是 你 的 一 个 粉丝 了 ， 太 感谢 了 ! -- Gadadhari Bheem 


我 在 学 习 Python 语 言 之 前 了 解 一 些 汇 编 、C、C++、C# 和 Java。 我 学 习 Python 语 言 的 原 
因 是 他 非常 流行 而 且 强 大 。 这 本 书 对 于 有 经 验 和 无 经 验 的 程序 员 都 是 一 本 很 好 的 教材 ， 
我 花 了 10 个 半天 看 完了 这 本 书 ， 非 常 有 局 发 1 -- Fang Biyi (PhD Candidate ECE, 
Michigan State University) 


感谢 作者 写 了 这 本 书 ! 这 本 书 解答 了 我 关于 Python 语言 的 很 多 问题 ， 比 如 面向 对 象 编程 
等 。 看 完 之 后 我 不 觉得 自己 就 成 了 面向 对 象 的 专家 了 ， 但 是 这 本 书 领 我 和 了 门 。 我 现在 
已 经 写 了 很 多 的 Python 程序 作为 系统 管理 员 的 工具 ， 他 们 都 是 面向 过 程 的 小 程序 。 最 后 
再 次 感谢 这 本 书 的 帮助 。 -- Bob 

我 想 感谢 你 写 了 这 本 书 ， 我 是 从 这 本 书 开始 学 习 编程 的 。Python 现 在 是 我 的 首选 开发 语 
言 了 。 感 谢 你 让 我 能 够 开发 出 很 多 有 用 的 小 工具 ， 在 学 习 Python 编 程 之 前 这 是 我 难以 想 
象 的 。-- "The Walrus" 
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我 想 谢谢 你 写 了 这 本 A Byte Of Python 。 这 本 书 对 于 我 学 习 Python 语 言 编 程 来 说 是 无 价 
之 宝 。 我 是 一 名 刚刚 入 门 的 程序 员 ， 几 个 月 前 刚刚 开始 学 习 。 之 前 我 都 是 通过 youtube 
A ee ee 
开始 几 页 我 就 学 习 到 了 之 前 从 来 无 法 企及 的 编程 知识 。 我 有 一 个 小 问题 ， 能 不 能 给 出 一 
些 最 新 的 例子 和 解释 ， 我 非常 期 待 继续 更 新 。 感谢 你 不 仅仅 写 了 这 本 书 ， 

布 。 感 谢 有 你 们 这 些 无 私 的 人 能 够 帮助 我 们 这 些 芸芸 众生 。 -- Chris 


我 在 2011 年 的 时 候 和 你 通信 联系 过 ， 现 在 我 重新 又 开始 Python 编程 ， 我 要 再 次 感谢 你 写 
了 这 本 "A Byte of Python"。 如 果 没 有 他 ， 我 不 知道 该 从 哪里 开始 。 我 从 那 时 起 在 我 们 公 
司 里 就 用 Python 写 了 很 多 的 程序 。 我 不 能 说 我 是 一 个 高 级 程序 员 ， 但 是 我 还 是 可 以 帮助 
到 周围 的 人 。 当 我 看 到 对 于 Byte 的 解释 的 时 候 ， 我 就 不 再 继续 学 习 C/C++ 语 言 了 ， 因 为 
我 发 现 开 始 就 讲 到 了 增 量 赋值 这 个 概念 没有 讲 清 楚 。 当 然 也 有 一 些 对 于 增 量 赋值 的 描 
述 ， 但 是 我 发 现 很 难 理解 。 我 并 不 是 说 C/C++ 语言 很 难 学 ， 或 者 我 自己 学 不 会 ， 我 只 是 
说 C/C++ 语言 的 文档 并 没有 仔细 的 定义 所 出 现 的 各 种 名 词 、 概 念 ， 以 至 于 学 习 起 来 非常 
费劲 。 就 好 像 计 算 机 无 法 理解 非 计 算 机 术语 一 样 ， 一 个 初学 者 刚 开始 接触 一 门 知 识 首 先 
需要 了 解 基 本 的 名 词 和 和 概念， 否则 就 会 出 现 “ 蓝 屏 "。 其 实 解决 方法 也 很 简单 ， 找 到 这 些 名 
词 和 概念 ， 给 出 合理 的 、 简 单 的 定义 。 感 谢 你 写 了 这 本 非常 的 浅显 匈 懂 的 书 。 我 希望 你 
能 够 继续 完成 全 部 的 名 词 解释 。Python 的 官方 文档 写 的 是 不 错 ， 但 是 很 难 让 初学 者 从 一 
开始 就 读 得 懂 。 第 三 方 的 入 门 教 程 应 该 快速 的 解释 一 些 单词 的 释义 以 便于 后 面 继续 讲解 
艰深 的 内 容 。 我 把 你 的 书 推荐 给 了 身边 的 人 ， 和 包括 澳洲 的 、 加 勒 比 的 、 美 国 的 。 祝 愿 你 
在 以 后 取得 更 大 的 成 功 1 -- Nick 


我 是 ankush， 今 年 19 岁 。 我 刚 开 始 学 习 Python 遇 到 了 很 大 的 困难 ， 我 翻 了 很 多 的 书 ， 但 
是 都 无 法 解决 我 的 问题 。 直 到 我 发 现 了 你 写 的 这 本 书 ， 它 让 我 爱 上 了 Python， 谢 谢 你 ! - 
-Ankush 


感谢 你 写 了 这 么 一 本 如 此 棒 的 Python 入 门 教材 。 我 是 一 名 分 子 生 物 学 的 研究 人 员 ， 编 程 
的 知识 了 解 不 多 ， 但 是 我 的 工作 需要 处 理 大 量 的 DNA 测 序 的 数据 以 及 分 析 微 观 世 界 的 图 
像 。 ATERT ER 来 说 ， 用 Python 编程 非 常 有 用 ， 没 有 他 我 就 无 法 完成 这 项 为 期 6 年 的 
项 目 。 这 么 棒 的 教材 居然 免费 提供 ， 这 说 明 世 界 上 还 是 有 好 心 人 的 啊 !1 :)--Luca 


如 果 这 是 你 第 一 次 学 习 编 程 语言 ， 你 应 该 看 《A Byte of Python》。 它 确实 从 适当 的 角度 
介绍 了 Python 程 序 设计 ， 并 且 后 续 的 深入 教程 也 不 是 很 难 。 最 重要 的 是 要 动手 写 程序 | - 
- "{Unregistered}" 


感谢 你 出 版 的 这 两 本 书 : 《A Byte of Python) 4 KA Byte of Vim》。 在 四 五 年 前 我 刚 开 
始 学 习 编程 的 时 候 非 常 有 用 。 现 在 我 正在 开发 一 个 项 目 ， 这 是 我 梦想 中 要 实现 的 项 目 ， 
我 想 说 一 声 : “谢谢 你 1 > HEA PK > MERAH MAA | -- Jocimar 


我 三 天 前 看 完了 《Abyte of Python) > SH ART ! 没有 一 个 字 的 废话 。 我 想 要 阅读 屏 
幕 识别 的 代码 ， 你 的 书 提供 了 非常 大 的 帮助 1 -- Dattatray 
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简介 


Hi, ÇA byte of python》 对 于 Python 初 学 者 来 说 丨 是 一 本 不 错 的 教材 ， 你 干 得 非常 棒 |! 
我 来 自 中国 ， 是 一 名 有 4 年 的 Java 和 C 的 经 验 的 程序 员 。 现 在 我 想 用 pygtk 做 一 些 zim-wiki 
note project 方 面 的 事情 。 我 用 6 天 的 时 间 看 完了 这 本 书 ， 现 在 我 可 以 写 Python 的 程序 

了 。 谢谢 你 的 贡献 ! 请 继续 保持 你 的 热情 ， 并 收 下 来 自 中 国 的 祝愿 1 -- Lee 

我 叫 lsen， 来 自 中 国 台 湾 , 是 台湾 国立 大 学 电子 工程 系 博 士 班 的 学 生 。 我 要 谢谢 你 写 了 这 
么 好 的 一 本 书 。 他 不 仅仅 非常 容易 理解 ， 而 且 对 于 Python 初学 者 来 说 也 足够 完整 。 我 阅 
读 这 本 书 是 因为 我 要 从 事 GNU Radio framework 这 方面 的 工作 。 你 的 书 让 我 迅速 的 抓 住 


了 Python 的 核心 思想 ， 并 且 学 会 了 Python 编程 。 我 注意 到 了 你 并 不 介意 读者 给 你 发 信息 


表示 感谢 ， 所 以 我 再 次 谢谢 你 写 了 这 么 好 的 一 本 书 。 -- Isen l-Chun Chao 


NASA 甚 至 也 使 用 这 本 书 ! 在 他 们 的 喷气 推进 实验 室 Jet Propulsion Laboratory 的 深 空 网 
项 目 中 使 用 。 


学 术 课 程 
本 书 正在 或 曾经 在 多 个 院 校 作为 教材 使 用 : 


e ' 编 程 语言 原理 '， 课 程 在 自由 大 学 , 阿姆斯特丹 Vrije Universiteit, Amsterdam 
o ' 计 算 的 基本 概念 ' 课 程 在 加 州 大 学 戴 维 斯 分 校 University of California, Davis 
o ' 使 用 Python 编 程 ' 课 程 在 哈佛 大 学 Harvard University 

o ' 编 程 导论 ' 课 程 在 英国 利兹 大 学 University of Leeds 

© ' 应 用 程序 编程 导论 ' 课 程 在 波士顿 大 学 Boston University 

o ' 气 象 学 信息 技术 ' 课 程 在 奥 克 拉 荷 马 大 学 University of Oklahoma 

e“' 地 理 数据 处 理 ' 课 程 在 密歇根 州立 大 学 Michigan State University 

o ' 多 代理 语义 网 络 系统 ' 课 程 在 英国 爱丁堡 大 学 University of Edinburgh 

e“' 计 算 机 科学 与 程序 设计 导论 ' at MIT OpenCourseWare 

o ' 程 序 设计 基础 课程 ， 利 久 不 加 纳 大 学 , 斯 洛 文 尼 亚 '-- Aleš Žiberna 


协议 
本 书 基 于 Creative Commons Attribution-ShareAlike 4.0 International License 协 议 。 
这 意味 着 : 


e 允许 自由 共享 (例如 复制 ) 、 分 发 以 及 传播 本 书 
e 允许 自由 混合 (例如 改编 ) AB 
e 允许 商业 目的 自由 使 用 


请 注意 : 


© 请 不 要 出 售 本 书 的 电子 或 纸 质 版 本 ， 除 非 你 在 说 明 书 中 清晰 而 明显 地 声明 ， 这 些 不 是 来 
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自 本 书 原作 者 。 

© 归属 必须 在 序言 以 及 文档 的 廊 页 以 链接 到 的 形式 标明 ， 并 明确 指出 原始 文本 可 以 在 此 地 
址 获得 。 

© 本 书 中 提供 的 所 有 代码 /脚本 基于 3-clause BSD License 协 议 许 可 ， 除 非 额 外 声明 。 


开始 阅读 


你 可 以 在 线 阅 读本 书 。 


购买 本 书 
为 了 离线 愉快 阅读 并 支持 本 书 的 持续 发 展 和 改善 ， 可 以 购买 纸 质 印刷 书籍 。 
下 载 


e PDF (for desktop reading, etc.) 
e EPUB (for iPhone/iPad, ebook readers, etc.) 
e Mobi (for Kindle) 


你 可 以 阅读 原文 查看 原始 的 内 容 以 便于 更 正 、 人 和 修订 、 翻 译 等 等 。 
阅读 本 书 的 翻译 


如 果 您 对 阅读 或 参与 本 书 的 翻译 感 兴趣 ， 请 看 翻译 。 


继续 阅读 致 效 


3} 
BAL 
感谢 Kalyan Varma 和 其 他 PESIT 的 管理 者 ， 他 们 带领 我 们 认识 了 GNU/Linux 和 开源 软件 。 


纪念 Atul Chitnis， 一 位 值得 永久 怀念 的 朋友 。 


感谢 互联 网 的 缔造 者 。 这 本 书 第 一 次 出 版 是 在 2003 年 ， 到 现在 仍然 非常 受 欢 迎 ， 感 谢 那 些 充 
满 想象 力 的 互联 网 缔造 者 ， 创 造 者 了 这 么 好 的 一 个 知识 分 享 平台 。 


继续 阅读 前 言 


Python 可 能 是 少数 的 几 个 既 简 单 易 学 又 功能 强大 的 编程 语言 之 一 。 对 于 初学 者 或 者 专家 来 说 
都 非常 适合 ， 尤 其 是 使 用 Python 编程 是 一 件 非常 快乐 的 事情 。 本 书 则 在 帮助 读者 学 习 这 门 伟 
大 的 语言 ， 让 编程 工作 变 的 更 加 轻松 。 这 就 是 所 谓 的 “ 工 欲 善 其 事 必 先 利 其 器 ”。 


“十 

读者 对 四 

本 书 作 为 Python 编程 语言 的 指南 或 教程 ， 主 要 面向 初学 者 ， 同 时 对 有 经 验 的 程序 员 也 用 
助 。 


本 书目 的 是 ， 如 果 对 于 计算 机 ， 你 只 知道 如 何 保存 文本 文件 ， 那 么 你 可 以 从 本 书 学 习 
Python。 如 果 之 前 你 有 编程 经 验 ， 那 么 你 同样 可 以 从 本 书 学 习 Python 。 


I 
et 


如 果 您 之 前 有 过 编程 经 验 ， 你 将 对 Python 和 你 喜欢 的 编程 语言 之 间 的 区 别 感 兴趣 一 我 请 
显示 了 这 些 区 别 。 然 而 要 提醒 一 点 ，Python 将 很 快 成 为 你 最 喜爱 的 编程 语言 ! 


官方 网 站 


本 书 的 官方 网 站 为 http://python.swaroopch.com/， 你 可 以 在 线 阅 读 全 部 的 内 容 ， 下 载 最 新 的 
版 本 ， 或 者 购买 纸 质 印刷 书籍 ， 也 可 以 给 我 反馈 。 


ER 
思考 的 一 些 事情 
构建 软件 设计 有 两 种 途径 : 一 种 是 足够 简单 以 致 明显 没有 缺陷 ， 另 一 种 是 足够 复杂 以 致 
没有 明显 缺陷 。 
-- C. A. R. Hoare 
人 生 的 成 功 ， 专 注 和 坚持 比 天 才 和 机 会 更 重要 。 


-- C. W. Wendte 


继续 阅读 关于 Python 
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Python 是 可 以 称 得 上 即 简单 又 功能 强大 的 少 有 的 语言 中 的 一 种 。 你 将 会 惊喜 地 发 现 ， 专 注 于 
么 容 


问题 的 解决 方案 而 不 是 你 正在 使 用 的 编程 语言 的 语法 以 及 结构 ， 是 多 


Se 


官方 对 Python 的 介绍 : 


Python 是 一 个 易于 学 习 的 、 功 能 强大 的 编程 语言 。 它 具有 高 效 的 高 级 数据 结构 和 能 够 简 
See eRe Re ion ies hese ee 起 ， 合 
其 在 多 个 平台 的 许多 领域 都 成 为 脚本 处 理 以 及 快速 应 用 开发 的 理想 语言 。 


在 下 一 章 ， 我 将 更 详细 地 讨论 这 些 特 性 。 


名 字 背 后 的 故事 


Python 语言 的 发 明 人 Guido van Rossum 尺 BBC 的 喜剧 《Monty s Flying Circus) 
给 这 个 语言 命名 。 他 不 是 特别 喜欢 那些 为 了 食物 而 杀 死 动物 的 蛇 ， 这 些 蛇 会 用 它们 长 长 
的 身体 缠绕 住 那些 动物 从 而 勒 死 它们 。 


Python 的 特点 
简单 


Python 是 一 门 简单 而 文字 简约 的 语言 。 阅 读 优秀 的 Python 程序 感觉 就 像 阅读 英语 ， 尽 管 是 非 
常 严格 的 英语 。Python 的 这 种 伪 代 码 特性 是 其 最 大 强项 之 一 ， 它 可 让 你 专注 于 解决 问题 的 办 
法 而 不 是 语言 E 本 身 。 


容易 学 习 


正如 你 即将 看 到 的 ，Python 非 常 容易 上 手 。 就 像 刚 刚 提 到 的 ，Python 具 有 格外 简单 的 语法 。 


免费 开源 


Python 是 一 个 FLOSS (自由 /自由 与 开源 软件 ) 的 例子 。 在 一 些 简单 的 条 款 之 下 ， 你 可 以 自由 
地 分 发 这 个 软件 的 拷贝 ， 阅 读 其 源 代码 ， 修 改 它 ， 或 者 将 其 一 部 分 用 到 新 的 自由 程序 中 。 
FLOSS 是 基于 共享 知识 社区 的 概念 ， 这 是 Python 如 此 好 的 原因 之 一 一 一 它 是 由 那些 希望 看 到 
更 好 的 Python 的 社区 创建 和 不 断 改 进 的 。 


当 你 使 用 Python 编写 程序 时 ， 你 永远 不 需要 担心 低级 细节 ， 比 如 你 的 程序 管理 内 存 的 使 用 


A 


FO 


可 移植 

基于 其 开放 源 代码 的 特性 ，Python 已 经 被 移植 (也 就 是 使 其 工作 ) 到 许多 平台 。 只 要 你 足够 
小 心 ， 避免 使 用 系统 相关 特性 ， 你 的 所 有 Python 程序 都 可 以 不 加 修改 地 运行 在 这 其 中 任意 平 
Zo 


4% T VA 7e Linux ` Windows ` FreeBSD ` Macintosh ` Solaris ` OS/2 ` Amiga ` AROS ` 
AS/400 ` BeOS ` OS/390 ` z/OS ` Palm OS ` QNX ` VMS ` Psion ` Acorn RISC OS >` 
VxWorks ` PlayStation ` Sharp Zaurus ` Windows CE > # 2 PocketPC # @ 44 A Python ° 


你 甚至 可 以 使 用 Kivy 平 台 为 iDOS (iPhone » iPad) 和 Android 创 建 游戏 。 


ka 


解释 


使 用 编译 型 语言 《 像 C 或 者 C++) 编写 的 程序 ， 会 由 编译 器 使 用 一 系列 标志 和 选项 ， 将 源 代码 
(如 C 或 者 C++) 转换 成 一 种 电脑 能 够 识别 的 语言 (二进制 代码 ， 也 就 是 0 和 1) 。 在 运行 程序 
时 ， 链 接 器 / 载 入 软件 将 程序 从 硬盘 复制 到 内 存 ， 然 后 开始 运行 。 


换 句 话说 ，Python 不 需要 编译 成 二 进 制 代 码 。 你 只 需 从 源 代码 直接 运行 程序 。 在 内 部 ， 
Python 将 源 代码 转换 成 一 种 称 为 字 节 码 的 中 间 格 式 ， 然 后 将 其 翻译 你 的 计算 机 的 机 器 语言 ， 
然后 开始 运行 。 事 实 上 ， 这 一 切 都 让 Python 的 使 用 更 为 简单 ， 因 为 你 不 必 担 心 程序 的 编译 、 
保证 恰当 的 库 被 链接 和 载 入 等 等 。 这 也 使 得 你 的 Python 程序 更 易于 移植 ， 因 为 你 只 需要 复制 
你 的 Python 程序 到 另外 一 台 计 算 机 ， 然 后 它 就 可 以 工作 了 ! 


面向 对 象 


Python 同时 支持 面向 过 程 和 面向 对 象 编 程 。 在 面向 过 程 语言 中 ， 程 序 围绕 着 过 程 或 者 函数 

(只 不 过 是 可 重复 使 用 的 程序 片段 ) 构建 。 在 面向 对 象 语言 中 ， 程 序 围绕 着 对 象 (数据 和 功 
能 的 组 合 ) 构建 。Python 具 有 非常 强大 但 是 过 于 简洁 的 执行 面向 对 象 编程 的 方式 ， 特 别 是 相 
对 于 C++ 或 者 Java 这 种 大 型 语言 来 说 。 


可 扩展 


如 果 你 需要 一 段 运行 很 快 的 关键 代码 ， 或 者 是 想 要 编写 一 些 不 愿 开 放 的 算法 ， 你 可 以 使 用 C 或 
C++ 完成 那 部 分 程序 ， 然 后 从 你 的 Python 程序 中 调用 。 


TRA 
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扩展 库 


Python 标准 库 的 确 很 大 。 它 能 够 帮助 你 完成 许多 工作 ， 包 括 正 则 表达 式 、 文 档 生 成 、 单 元 测 
试 、 线 程 、 数 据 库 、 网 页 浏览 器 、CGI (公共 网 关 接 口 ) 、FTP (文件 传输 协议 ) 、 电 子 邮 
件 、XML (可 扩展 标记 语言 )、XML-RPC (远程 方法 调用 ) 、HTML (起 文本 标记 语言 ) ` 
WAV (音频 格式 ) 文件 、 加 密 、GUI CA 以 及 其 它 系统 相关 的 代码 。 记 住 ， 只 
要 安装 了 Python， 所 有 这 些 都 能 做 到 。 这 叫做 Python 的 “ 喀 控 器 "哲学 。 


除了 标准 库 ， 还 有 各 式 各 样 的 其 它 高 质量 库 ， 你 可 以 在 Python 包 索 引 找 到 它们 。 


小 结 


Python 的 确 是 一 个 激动 人 心 的 功能 强大 的 语言 。Python 那 种 性 能 和 特性 的 恰到好处 的 组 合 让 
使 用 Python 编程 婚 有 趣 又 简单 。 


Python 3 vs 2 
如 果 你 不 关心 Python 2 和 Python 3 的 区 别 ， 可 以 跳 过 这 一 节 。 但 是 必须 知道 你 正在 使 用 的 版 
本 。 本 书 使 用 Python 3 完成 。 


一 旦 你 充分 地 理解 或 学 习 使 用 了 其 中 的 一 个 ， 你 可 以 很 容易 学 到 两 个 版 本 之 间 的 区 别 ， 然 后 
很 容易 的 适应 。 困 难 的 是 学 习 编 程 和 理解 Python 语言 的 核心 ， 这 是 本 书 的 目标 。 一 旦 你 达到 
这 个 目标 ， 你 可 以 根据 自己 的 情形 很 容易 的 使 用 Python 2 或 Python 3。 


关于 Python 2 和 Python 3 的 详细 区 别 ， 请 参考 : 


e Python 2 的 未 来 

e 将 Python 2 代码 移植 到 Python 3 

e 怎样 书写 能 够 同时 运行 在 Python2 and 3 中 的 代码 
e 使 用 Python 3: 深度 指南 


程序 员 说 了 些 什 么 


或 许 你 会 对 顶尖 的 黑客 ， 比 如 ESR， 怎 么 看 待 Python 感 兴趣 : 


关于 Python 


Eric S. Raymond > Æ «The Cathedral and the Bazaar》 的 作者 ， 也 是 发 明 开 放 源 代码 
这 一 术语 的 人 。 他 说 ，Python 已 经 成 为 他 最 喜欢 的 编程 语言 。 这 篇 文章 给 我 第 一 次 关注 
Python 49 ŽE RR ° 


Bruce Eckel > # #2) «Thinking in Java) 4° «Thinking in C++) 的 作者。 他 说 ， 没 有 
什么 语言 能 比 Python 更 能 令 他 高 效 。 他 说 ，Python 或 许 是 唯一 让 程序 员工 作 更 简单 的 一 
个 语言 。 请 看 完整 的 采访 。 

Peter Norvig， 是 著名 的 Lisp 的 作者 ，Google 搜 索 质 量 主 管 (感谢 Guido van Rossum 指 
出 ) 。 他 说 用 Python 编程 就 像 是 在 写 诗 一 样 。 ，Python 一 直 是 Google 的 主要 部 
分 。 你 可 以 通过 查看 Google Jobs 验 证 这 和 句 话 。 这 个 页 面 上 显示 出 ，Python 知 识 是 招聘 软 
件 工程 师 的 要 求 之 一 。 


继续 阅读 安装 


本 书 所 描述 的 "Python 3"， 指 的 是 Python 3.5.2 或 更 高 的 版 本 。 


在 Windows 上 安装 


访问 [下 载 ]https://www.python.org/downloads/ 最 新 版 本 。 安 装 过 程 和 其 它 基 于 Windows 的 软 
件 类 似 。 


EES 
警告 


一 定 要 选择 add Python 3.5 to PATH 


如 果 想 要 修改 安装 路 径 ， 点 击 customize installation 再 点 击 Next ， 键 入 C:\python35 作为 
新 的 安装 路 径 。 

如 果 在 安装 的 时 候 没有 选择 ， 那 么 请 添加 Python 环境 变量 . 这 和 add python 3.5 to PATH 效果 相 
同 。 

你 可 以 选择 为 所 有 用 户 安装 Python Launcher， 这 不 是 特别 重要 的 选项 。Launcher 用 来 在 不 同 
的 Python 版 本 之 间 进 行 切换 。 

如 果 你 指定 的 安装 路 径 不 正确 ， 你 需要 修正 人 他。 否则， 请 参考 在 Windows 命 令 行 上 运行 python ° 
提示 : 对 于 有 经 验 的 程序 员 ， 如 果 你 对 Docker 比 较 熟 悉 ， 请 参考 Python in Docker 和 Docker 


on Windows. 


DOS 提 示 符 


如 果 你 想 要 在 Windows 命 名 行 ， 例 如 DOS 提 示 符 ， 使 用 Python， 那 么 你 需要 正确 设置 PATH 变 


a 
o 


里 


对 于 Windows 2000、XP、2003， 点 击 控制 面板 --- 系 统 --- 高 级 --- 环 境 变 量 。 在 “系统 变量 "中 点 
击 PATH， 选 择 编辑 ， 然 后 在 已 有 内 容 的 最 后 部 分 添加 ;C:\Python35 (请 核实 存在 该 文件 夹 ， 
对 于 较 新 版 本 Python 来 说 ， 文 件 夹 的 名 字 可 能 不 同 ) 。 当 然 ， 要 使 用 正确 的 目录 名 。 

对 于 早期 版 本 的 Windows， 打 开 C:WAUTOEXEC.BAT 文 件 ， 添 加 一 

行 “PATH=%PATH%;C:APython35”《〈 不 含 引 号 ) ， 然 后 重启 系统 。 对 于 Windows NT， 使 用 
AUTOEXEC.NT 文 件 。 


对 于 Windows Vista: 


。 点 击 " 开 始 "， 选 择 “ 控 制 面板 ”。 


点 击 “ 系 统 "， 在 右 侧 您 将 看 到 “查看 计算 机 基本 信息 ”。 

左 侧 是 一 个 任务 列表 ， eae 级 系统 设置 "， 点 击 它 。 

© 显示 “系统 属性 ?对 话 框 * 高 级 "选项 卡 。 点 击 右 下 角 的 “环境 变量 ?按钮 。 
© 在 下 方 标题 为 “系统 变量 " 框 中 ， 滚 动 "Path”， 点 击 “ 编 辑 " 按 钮 。 

按 需 修改 路 径 

© 重启 系统 。 除 非 重 启 ，Vista 不 会 意识 到 系统 路 径 变量 的 修改 。 


对 于 Windows 7/8/10: 


© 在 桌面 上 右 击 “ 计 算 机 ”， 选 择 “ 属 性 ”; 或 点 击 “ 开 始 "， 选 择 “ 控 制 面板 ”---" 系 统 和 安全 ”---“ 系 
统 "， 点 击 左 侧 的 “高 级 系统 设置 "， 然 后 选择 “高 级 "选项 卡 。 点 击 底 部 的 “环境 变量 "按钮 ， 
在 下 方 的 “系统 变量 "中 找到 PATH 变量 ， 选 中 它 点 击 “ 编 辑 ”。 

e 在 变量 值 的 最 后 ， eens 。 如 果 这 个 值 是 %SystemRoot%'\system32;， 它 将 
变 成 %SystemRoot%'\system32;C:\Python35 ° 

。 点击“ 确定" 完成 。 不 需要 重启 。 


在 Windows 命 令 行 上 运 een 
对 于 Windows 用 户 ， 如 果 正 确 设置 了 PATH 变量 ， 你 可 以 在 命名 行 运行 解释 器 。 
要 打开 Windows 终 端 ， 点 击 开 始 按钮 ， 点 击 “ 运 行 "。 在 对 话 框 输入 cmd， 按 下 回 车 键 。 


然后 输入 


python -V 


确保 没有 错误 。 


在 Mac OS X 上 安装 


对 于 Mac OS X 用 户 ， 使 用 Homebrew 命 令 : brew install python3 安装 。 


通过 按 Command+Space 键 打开 终端 (打开 Spotlight 搜 索 ) ， 输 入 terminal 然后 回 车 。 之 
后 ， 运 行 


python3 -V 


确保 没有 错误 。 


在 GNU/Linux 上 安装 


对 于 GNU/Linux 用 户 ， 使 用 你 的 Linux 发 行 版 的 包 管 理 器 来 安装 Python 3， 例 如 如 果 你 使 用 的 
是 Debian & Ubuntu: sudo apt-get update && sudo apt-get install python3 ° 


对 于 Linux 用 户 ， 通 过 打开 Terminal 应 用 程序 打开 终端 ， 或 者 按 下 Alt + F2， 然 后 输入 gnome- 
terminal。 如 果 不 成 功 ， 请 参考 文档 或 你 所 用 Linux 发 行 版 的 论坛 。 


一 旦 你 完成 安装 ， 在 shell 运 行 python3 -V， 在 屏幕 上 你 应 该 能 够 看 到 Python 版 本 : 


$ python3 -V 
Python 3.5.2 


提示 : 是 shell 的 提示 符 ， 根 据 你 电脑 上 的 操作 系统 的 设置 会 有 所 不 同 ， 因 此 我 将 使 用 $ 符 号 。 


注意 : 在 不 同 的 电脑 上 输入 信息 可 能 会 有 所 不 同 ， 取 决 于 你 安装 的 Python 版 本 。 


总 ot 
A 一 器 


现在 开始 ， 我 们 假设 你 已 经 在 你 的 系统 上 安装 好 了 Python 3 。 


接 下 来 ， 我 们 将 开始 编写 我 们 的 第 一 个 Python 程序 。 


继续 阅读 第 一 步 


第 一 步 


现在 ,我 们 将 看 到 在 Python 中 如 何 运行 一 个 传统 的 “Hello World” 程 序 。 这 将 教 你 如 何 写 、 保 存 
和 运行 Python 程序 。 


使 用 Python 运行 你 的 程序 有 两 种 方法 一 -使 用 交互 式 解 释 器 提示 符 或 使 用 一 个 源 文 件 。 现 在 ， 


我 们 将 看 到 如 何 使 用 这 两 种 方法 。 





使 用 解释 器 提示 符 


在 您 的 操作 系统 中 打开 终端 (如 前 面 安装 所 述 ), 然 后 ， 输 入 pythons 按 回 车 键 ， 打 开 Python 提 


一 ke 


示 符 。 


一 旦 你 启动 python 3, 您 应 该 看 到 '>>>”, 这 被 称 为 Python 解 释 器 提示 符 ， 你 可 以 开始 输入 Python 
程序 。 


在 Python 解 释 器 提示 符 下 ， 输 入 


print("Hello World") 


然后 按 回 车 键 。 您 应 该 看 到 输出 了 单词 “Hello World” ° 


当 使 用 一 个 Mac OS X 计 算 机 ， 下 面 是 你 将 看 到 的 一 个 例子 。Python 软 件 的 细节 会 根据 你 的 电 
脑 不 同 而 有 所 不 同 ， 但 从 提示 符 ( 即 从 “>>>” 开 始 ) 与 操作 系统 无 关 ， 应 该 是 相同 。 


> python3 

Python 3.5.2 (default, Jan 14 2016, 06:54:11) 

[GCC 4.2.1 Compatible Apple LLVM 7.0.2 (clang-700.1.81)] on darwin 
Type "help", "copyright", "credits" or "license" for more information. 
>>> print("Hello World") 

Hello World 


注意 ,Python 让 你 的 代码 行 立即 输出 了 | 你 刚才 输入 的 是 一 个 Python 语 句 。 我 们 使 用 print 输出 
(不 出 所 料 ) 你 提供 给 它 的 任何 值 。 在 这 里 ,我 们 提供 的 是 文本 “Hello World”, 并 立即 打印 到 屏幕 
上 o 


如 何 退出 解释 器 提示 符 


如 果 你 正在 使 用 一 个 Linux 或 Unix shell, 您 可 以 通过 按 下 [ctrl - d] 或 输入 exit() (注意 :记得 
包含 括号 , () )， 然 后 输入 回 车 键 。 


如 果 您 使 用 的 是 Windows 命 令 行 提示 符 , 按 [ctrl - z] 键 再 按 回 车 键 ， 退 出 解释 器 提示 符 。 


选择 一 个 编辑 器 


我 们 不 能 在 每 次 想 要 运行 一 些 东 西 的 时 候 都 要 在 解释 器 提示 符 下 输入 我 们 的 程序 ， 所 以 我 们 
必须 把 它们 保存 为 文件 ， 这 样 我 们 可 以 任意 次 地 运行 我 们 的 程序 。 


要 创建 我 们 的 Python 源 文件 ,我 们 需要 一 个 可 以 输入 并 保存 它们 的 编辑 软件 。 一 个 优秀 的 程序 
员 的 编辑 器 将 使 你 写 源 代码 文件 的 生活 更 容易 。 因 此 ， 选 择 一 个 编辑 器 确实 至 关 重 要 。 你 必 
须 选 择 一 个 编辑 器 ， 就 像 你 选择 要 买 的 汽车 一 样 。 一 个 好 的 编辑 器 会 帮助 您 很 容易 地 编写 
Python 程 序 ， (就 像 一 辆 车 可 以 让 你 ) 以 一 个 更 快 和 更 安全 的 方式 ， 让 你 的 旅程 更 舒适 ， 并 
且 可 以 帮助 你 实现 你 的 目标 。 


一 个 非常 基本 的 需求 是 语法 高 亮 元 显示 2 YB 以 不 同 的 彩色 显 示 你 的 Python 程序 所 有 的 不 同 部 
分 ， 以 便 您 可 以 看 到 你 的 程序 且 使 其 运 # ene ° 


如 果 你 不 知道 从 哪里 开始 ， 我 推荐 可 以 在 Windows、Mac OS XF GNU/Linux 1% A 49 Visual 
Studio Code( 简 称 VYSCode) 免 费 软件 与 Python 插 件 (ext install python) ° 





如 果 您 使 用 的 是 Windows， 不 要 使 这 是 一 个 糟糕 的 选择 ， 因 为 它 不 做 语法 高 亮 
显示 ， 而 且 更 重要 的 是 它 不 支持 文字 的 缩 进 一 一 之 后 我 们 在 我 们 的 例子 中 会 看 到 ， 缩 进 是 非 


常 重要 的 。 好 的 编辑 器 如 Komodo Edit 会 自动 地 做 到 这 一 点 。 


如 果 你 是 一 名 有 经 验 的 程序 员 ， 那 么 你 一 定 已 经 使 用 Vim 或 Emacs 了 。 不 用 说 ， 这 是 两 个 最 强 
大 的 编辑 器 ， 使 用 它们 来 写 你 的 Python 程序 ， 你 会 从 中 受益 。 就 我 自己 而 言 ， 在 我 的 大 多 数 
AEE GHA HAA AV o 


从 长 远 来 看 Vim 或 者 Emacs 是 非常 有 用 的 ， 如 果 你 愿意 花 时 间 去 学 习 ， 那 么 我 强烈 建议 你 使 用 
它们 。 然 而 ,正如 我 之 前 提 到 的 ,初学 者 可 以 从 PyCharm 开 始 学 习 Python 而 不 是 编辑 器 


再 次 重申 ， 请 选择 一 个 适当 的 编辑 器 ， 它 可 以 使 编写 Python 程序 更 有 趣 和 更 容易 。 


VSCode 


Visual Studio Code 是 一 个 免费 的 集成 开发 环境 IDE) ， 你 可 以 用 它 开 发 Python 程序 。 


下 载 安装 之 后 ， 在 菜单 中 选择 “查看 ”->" 扩 展 "， 然后 输入 python ， 选 择 由 Don Jayamanne 开发 
的 Python 扩展 安装 即 可 。 


© 扩展 名 : Python 
扩展 = ++ #8: Python x 


python 
Python 
Python Extended 


Python Extended is a vscod.. Don Jayamanne | 4 322019 kk kkk 49 许可 证 
安装 


Linting, Debugging (multi-threaded, remote), Intellisense, code formatting, refactoring, snippets, and more. 
Python for VSCode 9, gging ( ' ), " g, g, snippets, 


Python language extension... BA ag 
安装 


Python 0.3.21 

Linting, Debugging (multi-t... 

Don Jayamanne 【启用 | #8 Python 

Python-autopep8 

This is a vscode-extension ... 
安装 

MagicPython + Linting ( ’ A 5 2 with config files and plugins) 


Syntax highlighter for cutti... Intellisense (autocompletion) 


MayaPort * Code formatting ( i , with config files) 
Simple vscode to Maya com.. 


An extension with rich support for the , with features including the following and more: 


+ Auto indenting 


* Code refactoring ( 


+ Renaming, Viewing references, and code navigation 


Docker Linter 


Lint perl, python and/or rub... i 3 i BE é 3 
ee + Excellent debugging support (variables, arguments, expressions, watch window, stack information, break points, remote debugging, 


+ View signature and similar by hovering over a function or method 


mutliple threads) 
Code Runner 


Run code snippet/file for js,... 
安装 « Snippets 


. Unit testing ( S , with config files) 


Pygame Snippets 
Pygame Snippets is a vsco... 


Quick Start 


+ Install the extension 
Wildlife Theme 


A dark and light vibrant col... You' avs it 
> You're ready to use it. 


« If Python is in the current path 


+ If using a custom Python Version or a Virtual Environment 
Tornado 


Tornado template support 


o Configure the path to the python executable in python. pythonPath of the settings. json file ( 





0040 


在 VSCode 中 ， 新 建 项 目 就 是 新 建 一 个 文件 夹 ， 你 可 以 使 用 操作 系统 的 资源 管理 器 新 建文 件 
夹 ， 然 后 在 当前 文件 夹 下 使 用 命令 行 code . 启动 VSCode。 也 可 以 在 VSCode 中 使 用 “文件 ”- 
>" 打 开 .… 打 开 这 个 文件 夹 。 


入 helloworld.py ， 


输入 以 下 代码 : 


print("hello world!") 


点 击 [ctrl+s] 保存 文件 之 后 ， 选 择 最 左 侧 的 调试 视图 ， 然 后 点 击 上 面 的 绿色 小 三 角 ， 运 
ÍF helloworld.py 程序 。 此 时 VSCode 会 弹出 一 个 列表 让 你 选择 环境 ， 在 这 里 选择 python PP 
可 。 


调 . > ”没有 配 ]$ <P 口 


4 VARIABLES 


4 WATCH 


4 CALL STACK 


4 BREAKPOINTS 
@ All Exceptions 
@ Uncaught Exceptions 
0040 


helloworld.py - helloworld 


hell 选择 环境 
Node.js 
VSCode 扩展 开发 
Python 
Chrome 
React Native 


行 1, 列 1 空格 : 4 


再 次 点 击 绿色 的 小 三 角 按 钮 ， 会 看 到 程序 没有 立即 运行 ， 而 是 进入 了 调试 状态 ， 在 中 间 出 现 
击 那个 绿色 的 小 三 角 按 钮 即 可 运行 程序 2 看 到 hello world! 的 输出 2 


了 调试 的 对 话 框 ， 点 


© 
调 . Python o DJ 
4 VARIABLES 


4 Local 
b {'Arithmetic. 


4 WATCH 


4 CALL STACK PAUSED ON ENTRY 


<module> launch.json 1 


4 BREAKPOINTS 
@ All Exceptions 
@ Uncaught Exceptions 
0040 


launch.json - helloworld 


launch.json 


k 


"version": 
"configurations": 
{ 

"name": 
"type": 
"request": 
“stopOnEntry": 
“pythonPath": 
"program": - 
“debugOptions": [ 


"name": 

"type": 

"request": "e 
“stopOnEntry": Je, 
“pythonPath": 
"program": , 


"externalConsnle": t 


调试 控制 台 


行 1, 列 1 空格 :4 UTF-8 LF JSON @ 


之 所 以 要 再 点 击 一 次 ， 是 因为 VSCode 的 Python 插件 默认 的 司 动 配置 为 : 





"stopOnEntry": true, 


可 以 修改 为 false， 这 样 以 后 点 击 “ 运 行 " 的 时 候 就 直接 执行 程序 了 。 


o Mac OS X 用 户 应 该 通过 HomeBrew 安 装 macvim 软件 ° 
o Windows 用 户 应 该 在 Vim 网 站 下 载 exe 安 装 文件 。 
o GNU/Linux 用 户 一 般 情 况 下 可 以 直接 使 用 vim ° 

2. 你 可 以 安装 jedi-vim 这 个 插件 为 vim 增 加 自动 完成 的 功能 。 

3. 女装 对 应 的 jedi python&: pip install -U jedi 


Emacs 


1. | 安装 Emacs 24+. 
o Mac OS X 用 户 从 http://emacsformacosx.com 获 得 emacs 
o Windows 用 户 从 http://ftp.gnu.org/gnu/emacs/windows/ 下 载 
o GNU/Linux 用 户 根据 不 同 的 发 行 版 获得 对 应 的 emacs 软 件 ， 比 如 Debian 和 Ubuntu 用 
户 可 以 安装 emacs24 软件 包 
2. 安装 ELPY 


4 FA] AR 


现在 让 我 们 回 到 编程 。 每 当 你 学 习 一 种 新 的 编程 语言 时 ， 有 一 个 传统 ， 你 编写 和 运行 的 第 一 
个 程序 是 “Hello World" 程 序 一 一 当 你 运行 它 时 ， 它 所 做 的 只 是 说 "Hello World”。 正 如 Simon 
Cozens( 神 奇 的 "Beginning Perl" 的 作者 ) 所 说 ， 这 是 “向 编程 神 祈 求 帮 你 更 好 学 习 语 言 的 传统 唤 


语 。 
开始 你 选择 的 编辑 器 ， 输 入 以 下 程序 并 将 其 保存 为 "hello.py ° 
如 果 你 使 用 VSCode 编 辑 器 ， 点 击 “ 文 件 ”->" 新 建文 件 ", 输 入 下 行 : 


print('Hello World') 


在 VSCode 编 辑 器 ， 选 "文件 >" 保存" 保存 文件 。 


你 应 将 文件 保存 在 哪里 ? 你 知道 位 置 的 任何 文件 夹 。 如 果 你 不 明白 这 是 什么 意思 ， 创 建 一 个 
新 文件 夹 ， 并 使 用 该 位 置 保存 和 运行 你 所 有 的 Python 程序 : 


。 C:\py 在 Windows 上 
e /tmp/py 在 Linux 上 
e /tmp/py Mac OS X 上 


使 用 'mkdir' 命 令 在 命令 行 创建 一 个 文件 夹 ， 例 如 “mkdir /tmp/py” ° 
重要 提示 : 确保 你 给 它 的 文件 扩展 名 是 .py， 例 如 ，“foo.py”。 
运行 你 的 Python 程序 : 

1， 打 开 一 个 命令 行 窗口 


2. 进入 你 刚才 保存 文件 的 目录 ， 例 如 : cd /tmp/py ° 
3. 键入 python hello.py 运行 python 程 序 ， 输 入 如 下 : 


$ python hello.py 
hello world 


eee 天 helloworld 一 -bash — 80x24 
$python hello.py 

hello world! 

sil 





如 果 你 得 到 了 如 上 所 示 有 输出 ， 祝 贺 你 | 一 一 你 已 经 成 功 地 运行 了 你 的 第 一 个 Python 程序 。 您 
已 经 成 功 地 越过 学 习 编 程 最 难 的 部 分 一 一 开始 你 的 第 一 个 程序 ! 


如 果 你 得 到 了 一 个 错误 ， 请 完全 输入 如 上 所 示 程 序 ， 再 次 运行 这 个 程序 。 注 意 ，Python 是 区 
分 大 小 写 的 ， 即 “print" 并 不 等 于 “Print* 注意 ， 前 者 是 小 写字 母 "p" 和 后 者 是 大 写字 母 <P"。 同 
样 ， 确 保 每 一 行 的 第 一 个 字母 之 前 没有 空格 或 制 表 符 一 一 之 后 我 们 将 明白 为 什么 这 很 重要 。 





它 是 如 何 工作 的 


Python 程序 是 由 语句 组 成 ， 在 我 们 的 第 一 个 程序 中 ， 我 们 只 有 一 个 语句 ， 在 这 个 语句 中 ， 我 
NAA “print Až > C A Æ} fP XA “Hello World” ° 


可 以 使 用 内 置 的 “help”( 帮 助 ) 功 


如 果 您 需要 快速 获取 任何 的 Python 辑 数 或 语句 的 信息 ， 那 么 您 
运行 "help(print)” 这 将 显示 


能 。 这 是 非常 有 用 的 ， 尤 其 是 当 使 用 翻译 提示 符 时 ， 例 如 ， 运 
print 函 数 的 帮助 一 一 用 于 打印 东西 到 屏幕 上 。 





注意 : 按 q 退 出 帮助 
类 似 地 ,您 可 以 获得 Python 中 几乎 任何 事情 的 信息 ， 使 用 "help()" 去 学 习 更 多 关于 使 用 help" 本 
身 的 信息 |! 


如 果 你 需要 获取 操作 符 ， 如 “return” 的 帮助 ， 那 么 你 只 需要 把 这 些 放 到 引号 内 部 ， 
如 “help('return') ， 所 以 ， 对 于 我 们 试图 要 做 的 事情 ，Python 并 不 感到 困 三 。 


K 


` ge 


wep» 
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现在 ， 你 可 以 自由 自在 地 编写 、 保 存 和 运行 Python 程序 了 。 


既然 你 是 一 名 Python 用 户 ， 让 我 们 学 习 一 些 Python 概 念 。 


继续 阅读 基础 


基础 


是 打印 :Hello Wonld 是 不 够 的 ， 是 吗 ? HA ALE Teo» HARA Be A» ARR 
4 在 Python 中 ， 我 们 使 用 常量 和 变量 可 以 实现 这 些 。 在 这 一 章 ， 我 们 还 将 学 
习 一 些 其 他 的 概念 。 


So 


注释 
注释 是 # 符 号 右边 的 任何 文字 ， 它 对 读 程序 的 人 有 很 大 用 处 。 


例如 : 


print('hello world') + > prints 


或 者 : 


t 注意 :print 是 一 个 函数 
print('Hello World') 


在 你 的 程序 中 ， 你 尽 可 能 使 用 有 用 的 注释 : 


。 解释 设想 

解释 重要 决策 

解释 重要 细节 

解释 你 在 试图 解决 的 问题 
解释 程序 中 你 在 努力 克服 的 问题 ， 等 等 。 


代码 告诉 你 怎样 做 ， 注 释 告诉 你 这 样 做 的 原因 。 


这 对 你 的 程序 的 读者 是 有 用 的 ， 他 们 可 以 很 容易 地 理解 程序 做 什么 。 记 住 ， 六 个 月 后 这 个 人 
可 以 是 你 自己 ! 


字面 常量 的 一 个 例子 是 一 个 数字 就 像 5 、1.23 ， 或 一 个 字符 串 像 “这 是 一 个 字符 串 ? 或 “ 它 一 
个 字符 串 "。 它 被 称 为 字面 ， 因 为 它 是 字面 的 一 一 你 使 用 它 的 字面 值 。 数 字 2 总 是 代表 本 身 
并 没有 什么 其 他 的 一 它 是 一 个 常数 ， 因 为 它 的 值 是 不 能 改变 的 ， 因 此 ， 所 有 这 些 被 称 为 字 
面 常 量 。 


数字 


数字 主要 有 两 种 类 型 -- 整 型 和 浮 点 数 。 
2 是 整数 的 一 个 例子 ， 它 只 是 一 个 完整 的 数 。 


浮 点 数 (或 简称 为 浮 点 ) 的 例子 有 3.23 和 52.3E-4 。 符 号 E 表 示 10 的 次 方 。 在 这 种 情况 
下 ，52.3E-4 的 意思 是 52.3 的 -4 次 方 。 
有 经 验 的 程序 要 注意 : Python 中 没有 单独 的 long( 长 ) 整 型 。int( 整 型 ) 可 以 是 任意 大 小 的 整 


数 。 


/> 大 大 
Zi e 
字符 囊 是 字符 的 一 个 序列 ， 字 符 串 通常 只 是 一 串 单 词 。 


在 你 写 的 每 一 个 Python 程序 中 都 要 使 用 字符 串 ， 因 此 要 注意 以 下 部 分 : 


单 引 号 
你 可 以 使 用 单 引 号 例如 'Quote me on this' 指 定 字 符 串 。 所 有 的 空白 ， 例 如 空格 和 制 表 符 都 按 
原样 保留 。 


双 引 号 


在 双 引 号 中 的 字符 串 和 在 单 引 号 中 的 字符 串 工作 起 来 完全 一 样 。 例 如 "Whats your name?" 


Ze hl 


您 可 以 使 用 三 重 引号 -("" 或 "指定 多 行 字符 串 。 在 三 重 引号 中 您 可 以 自由 使 用 单 引号 和 双 引 
号 。 例 如 


'''This is a multi-line string. This is the first line. 
This is the second line. 

"What's your name?," I asked. 

He said "Bond, James Bond." 


字符 事 是 不 可 改变 的 


您 已 经 创建 了 一 个 字符 囊 ， 你 就 不 能 改变 它 。 虽 然 这 看 起 来 似乎 是 一 件 坏 


这 意味 着 ， 一 旦 
事 ， 但 它 卜 不 是 (坏事 )。 在 我 们 后 面 看 到 的 各 种 程序 中 ， 将 会 明白 这 不 是 一 个 限制 。 


C/C++ 程序 员 要 注意 : 在 Python 中 没有 单独 的 char"( 字 符 型 ) 数 据 。 这 里 没有 上 正 的 需要 
它 ， 我 相信 你 不 会 想念 它 。 

Perl/PHP 程 序 员 要 注意 : 记 住 ， 单 引号 字符 串 和 双 引 号 字符 串 是 相同 的 
何方 式 不 同 。 


他 们 不 以 任 





格式 方法 
有 时 ， 我 们 可 能 想 要 从 其 它 信 息 构 建 字符 串 。 这 就 是 “format()" 方 法 有 用 之 处 。 


保存 下 面 几 行 到 文件 "str format.py" 中 : 


age = 20 
name = 'Swaroop' 


print('{0} was {1} years old when he wrote this book'.format(name, age) ) 
print('Why is {0} playing with that python?'.format(name) ) 


输出 结果 为 : 


python str_format.py 
Swaroop was 20 years old when he wrote this book 
Why is Swaroop playing with that python? 


它 是 如 何 工 作 的 : 


一 个 字符 串 可 以 使 用 特定 的 格式 ， 随 后 调用 format 方 法 ， 用 format 方 法 替代 那些 使 用 适当 参数 
的 格式 。 


观察 使 用 第 一 处 ， 我 们 使 用 0 对 应 于 变量 "name', 这 是 format( 格 式 ) 方 法 的 第 一 个 参数 。 类 似 
的 ,第 二 个 格式 是 “{1》" 对 应 的 “age”, 这 是 格式 方法 的 第 二 个 参数 。 注 意 ，Python 从 0 开始 计数 ， 
这 意味 着 第 一 位 置 的 索引 是 0， 第 二 个 位 置 的 索引 是 1， 等 等 。 


注意 ， 我 们 可 以 使 用 字符 串 的 连接 
name + 'is' + str(age) + ‘years old' 
实现 同样 的 目的 ， 但 这 非常 讨厌 、 容 易 出 错 。 第 二 ， 在 这 种 情况 下 ， 通 过 format 方 法 自动 转换 


为 字符 串 ， 而 不 是 显 式 地 转换 为 需要 的 字符 串 。 第 三 ， 当 使 用 的 format 方法 ， 我 们 可 以 改变 
消息 ， 而 无 需 处 理 使 用 的 变量 ， 反 之 亦 然 。 


还 要 注意 ， 这 些 数字 (索引 ) 都 是 可 选 的 ， 所 以 你 也 可 以 写成 : 


age = 20 
name = 'Swaroop' 


print('{} was {} years old when he wrote this book'.format(name, age) ) 
print('Why is {} playing with that python?'.format(name) ) 


这 将 给 与 前 面 的 程序 相同 的 输出 。 


Python 在 format 方 法 中 做 的 是 ， 用 每 个 参数 值 蔡 代 规格 的 地 方 。 这 里 有 更 详细 的 规格 ， 如 : 


# decimal (.) precision of 3 for float '0.333' 
print('{0:.3f}'.format(1.0/3)) 

# fill with underscores (_) with the text centered 

# (4) to 11 width ' hello__' 

print('{0:_411}'.format('hello')) 

# keyword-based 'Swaroop wrote A Byte of Python' 

print('{name} wrote {book}'.format(name='Swaroop', book='A Byte of Python')) 


输出 为 : 


0.333 
hello 
Swaroop wrote A Byte of Python 


既然 我 们 正在 讨论 格式 化 ， 大 家 应 该 也 已 经 注意 到 了 : print 函数 每 次 都 会 在 输出 的 最 后 增 
加 一 个 回 车 ， 这 保证 了 我 们 重复 调用 print 函数 每 次 都 能 输出 在 不 同 的 行 。 如 果 想 要 去 掉 这 
个 回 车 ， 可 以 给 print 函数 一 个 end 参数 并 设置 为 空 即 可 ， 例 如 : 


print('a', end='') 
print('b', end='') 


输出 是 : 


ab 


或 者 你 也 可 以 给 end 参数 指定 为 空格 : 


print('a', end=' ') 
print('b', end=' ') 
print('c') 


输出 为 : 


转 义 字符 


假设 你 想 要 一 个 带 单 引 号 ( ) 的 字符 囊 ， 你 会 怎么 写 呢 ? 例如 你 想 输出 "what's your 

name?" ° 你 不 能 写成 'What's your name?', 因为 python 会 摘 不 清 字 符 串 是 从 哪 开 始 又 是 从 哪 结 
束 。 所 以 你 需要 告诉 python 字 符 串 中 间 的 单 引号 并 不 是 字符 串 的 结束 标志 。 利用 转 义 字符 可 
以 做 到 这 点 。 将 单 引 号 替换 成 /' - 注意 反 和 斜 林 ， 这 样 字 符 串 就 变 成 'What/'s your 


name?' 了 . 


另 一 个 办 法 是 使 用 双 引 号 what's your name?" ° 不 过 当 你 需要 双 引 号 的 时 候 和 单 引 号 的 情况 
类 似 ， 必 须 加 上 反 斜 杠 嫩 ， 而 反 斜 枉 也 一 样 必须 表示 成 // © 


如 果 你 需要 一 个 双 行 字符 串 呢 ? 一 个 办 法 是 使 用 前 面 提 到 的 三 引号 或 者 使 用 换行 的 转 义 字 
符 \n 开始 新 的 一 行 ， 例 如 : 


"This is the first line\nThis is the second line' 
还 有 一 个 有 用 的 转 义 字符 \t 表示 tab, 转 义 字符 太 多 了 我 只 说 了 常用 的 。 
另 一 个 值得 注意 的 地 方 是 在 一 个 字符 串 末 尾 的 反 斜 杠 表示 这 个 字符 串 将 被 合并 到 下 一 行 , 例如 : 


"This is the first sentence. \ 
This is the second sentence." 


上 面 的 字符 囊 等 价 二 


"This is the first sentence. This is the second sentence." 


原始 字符 串 


如 果 你 不 希望 python 对 字符 囊 进行 特别 处 理 , 不 希望 使 用 转 义 字符 , 可 以 为 字符 囊 加 上 前 级 [或 
R， 这 样 的 字符 串 就 是 原始 字符 串 。 例 如 : 


r"Newlines are indicated by \n" 


正则 表达 式 用 户 请 注意 


永远 使 用 原始 字符 串 编写 正则 表达 式 , 否则 会 需要 大 量 的 反 斜 杠 , 例如 反 向 引用 可 以 表示 
A WT AN 


wR 号 


又 里 


仅仅 使 用 字面 常量 
就 要 引入 变量 。 变 示 的 东西 一 他 们 的 值 会 有 所 不 同 。 例 如 ， 你 可 以 用 变 
量 存储 任何 值 。 变 量 是 你 电脑 中 存储 信息 的 内 存 的 一 部 分 。 不 像 字 面 常量 ， 您 需要 某 种 方法 
来 访问 这 些 变量 ， 因 此 你 要 给 出 他 们 的 名 字 。 


会 很 快 变 得 无 聊 一 一 我 们 需要 某 种 方式 存储 任何 信息 ， 同 样 操作 它们 。 这 
量 


是 
量 是 


变量 是 标识 符 的 一 个 示例 。 标 识 符 是 用 来 识别 一 些 东 西 的 名 字 。 这 里 有 一 些 你 必须 遵循 的 标 
识 符 命名 规则 : 


© 标识 符 的 第 一 个 字符 必须 是 字母 表 中 的 一 个 字母 (大 写 或 小 写 的 ASCII 或 Unicode 字 符 ) 或 
下 划 线 ( _ )。 

o 标识 符 名 称 的 其 余部 分 可 以 包含 字母 (大 写 或 小 写 的 ASCI| 或 Unicode 字 符 ) 下 划 线 ( ) 
或 数字 (0 - 9) ° 

o 标识 符 的 名 称 都 是 区 分 大 小 写 的 。 例 如 ， myname 和 myName 不 相同 。 注 意 前 者 中 n 小 写 和 
后 者 中 N 大 写 。 

© 有 效 的 标识 符 名 称 的 例子 有 : i, myname , name23 。 无 效 的 标识 符 名 字 的 例子 


有 > 2things , this is spaced out , my-name 和 >alb2_c3 ° 


数据 类 型 


变量 可 以 保存 不 同 的 被 称 为 数据 类 型 的 数值 。 基 本 类 型 是 数字 和 字符 串 ， 我 们 已 经 讨论 了 。 
在 后 面 的 章节 中 ， 我 们 将 看 到 如 何 使 用 类 创建 自己 的 类 型 。 


at R 


记 住 ，Python 把 程序 中 使 用 的 任何 东西 作为 一 个 对 象 。 在 常识 中 这 意味 着 ， 我 们 说 ' 对 象 '， 而 
不 是 说 ' 一 些 东西 ， 


cate 


面向 对 象 编程 的 用 户 要 注意 : 一 切 东西 都 是 对 象 ， 包 括 数 字 、 字 符 串 和 函数 ， 在 这 个 
义 上 讲 ，Python 是 坚定 的 面向 对 象 的 。 


现在 ， 我 们 将 看 到 如 何 使 用 变量 以 及 字面 常量 。 保 存 下 面 的 示例 ， 运 行 这 个 程序 。 


7 5 Python 


从 此 以 后 ， 保 存 和 运行 一 个 Python 程序 的 标准 过 程 如 下 : 


1. 打开 选择 的 编辑 器 ， 例 如 VS Code 。 


2. 输入 例子 中 给 出 的 程序 代码 。 
3. 用 提 到 的 文件 名 保存 为 文件 。 
4. 在 命令 行使 用 python program.py 命 令 运行 程序 。 


例如 : 使 用 变量 和 常量 
Filename : var.py 


# Filename : var.py 
i=5 

print(i) 

i=it+d 

print(i) 


s = '''This is a multi-line string. 
This is the second line.''' 
print(s) 


输出 结果 为 : 


5 

6 

This is a multi-line string. 
This is the second line. 


它 是 如 何 工作 的 


下 面 介绍 这 个 程序 如 何 工作 的 。 首 先 ， 我 们 使 用 Sane. ) 为 变量 i 指定 了 字面 常量 
A 5 ,这 一 行 叫 做 一 个 声明 ， 因 为 它 指 出 应 该 做 一 些 事情 这 个 例子 中 ， pees i 的 

量 与 值 5 相 联系 。 接 下 来 ,我 们 使 用 print HAAT i > 不 出 所 料 ， 恰 恰 打 印 变量 的 
值 到 屏幕 上 ° 


然后 ， 我 们 给 存储 在 变量 i 中 的 值 加 1 后 ， 再 存 回 到 i 中。 然后， 我 们 把 它 打 印 出 来 ， 我 
我 们 想 的 一 样 ， 我 们 得 到 值 6 。 


同样 ， 我 们 为 字符 串 变 量 s 指定 了 字面 常量 字符 串 ， 然 后 打印 它 。 


静态 语言 程序 员 应 注意 变量 的 使 用 只 是 通过 给 他 们 指定 一 个 值 。 不 需要 /不 使 用 声明 或 数 
据 类 型 定义 。 


加 辑 行 与 物理 行 


物理 行 是 当 你 写 程序 时 看 到 的 一 行 。 人 逻辑 行 是 Python 看 到 的 一 个 单独 语句 。Python 默 认 一 个 
物理 行为 一 个 逻辑 行 。 


一 个 逻辑 行 是 一 个 语 钉 ， 像 print('Hello world') 一 一 如 果 它 本 身 在 一 行 上 ( 像 你 在 一 个 编辑 
器 中 看 到 的 ) ， 那 么 ， 它 也 是 一 个 物理 行 。 


默认 情况 下 ，Python 鼓 励 一 行 写 一 个 语句 的 用 法 ， 这 使 代码 更 可 读 。 


果 您 想 要 在 一 个 物理 行列 举 多 个 逻辑 行 ， 那 么 您 必须 使 用 一 个 表示 歇 辑 行 /语句 结束 的 分 
号 ; 显 式 地 指明 。 例 如 : 


i=5 
print(i) 


与 


Ic 5s 
print(i); 


同样 可 写成 : 


i = 5; print(i); 


HER 


i = 5; print(i) 


ita > RARER EAE BITRE PRAM EAT o RRA ATLA 
分 号 。 事 实 上 ， 我 从 未 使 用 ， 其 至 在 python 程 序 中 从 来 没有 见 过 一 个 分 号 
念 
为 多 


是 很 有 用 的 ， 还 有 一 种 情况 : es ART VAM tR A atie E 
个 物理 行 。 这 是 被 称 为 显 式 行 连 
PA 
是 字符 串 的 继续 。' 
o 


这 是 一 个 字符 囊 。 这 是 字符 囊 的 继续 。 


相同 


有 时 有 一 种 隐 含 的 假设 ， 您 不 需要 使 用 一 个 反 斜 杠 。 在 这 种 情况 下 ， 人 逻辑 行 有 一 个 开始 圆 括 
号 、 开 始 方 括号 或 开始 花 括 号 ， 但 不 是 一 个 结束 的 括号 。 这 被 称 为 隐 式 连接 。 当 我 们 在 以 后 
的 章节 一 一 编写 程序 使 用 列表 时 ， 你 可 以 看 到 它 的 作用 。 


缩 进 


在 Python 中 的 空白 是 重要 的 。 实 际 上 ， 在 一 行 开始 的 空格 是 重要 的 。 这 被 称 为 缩 进 。 在 逻辑 
行 开头 的 前 导 空白 (空格 和 制 表 符 ) 用 于 确定 逻辑 行 的 缩 进 级 别 ， 它 用 于 依次 确定 语句 的 分 组 。 


这 意味 着 一 起 的 语句 必须 有 相同 的 缩 进 。 每 一 个 这 样 的 语句 组 被 称 为 块 。 在 后 面 的 章节 ， 我 
们 将 看 到 的 块 是 何等 重要 的 例子 


你 应 该 记 住 的 一 件 事 是 ， 错 误 的 缩 进 可 以 产生 错误 。 例 如 : 


i=5 
print('M2 ', i) # 错误 ! 注意 在 行 的 开头 有 一 个 空格 
print(' 重 复 ， 值 是 '，i) 


当 运 行 它 时 ， 将 会 发 生 下 面 的 错误 : 


File "whitespace.py", line 4 


print('Value is ', i) # Error! Notice a single space at the start of the line 
A 


IndentationError: unexpected indent 


请 注意 ， 人 。 这 个 错误 表明 : Python 告诉 我 们 程序 的 语法 是 无 效 
的 ， 即 程序 写 的 不 正确 。 这 意味 着 ， 你 不 能 任意 开始 语句 中 的 新 块 (当然 ， 除 了 默认 的 主 块 ， 
您 一 直 已 经 使 用 的 )。 您 可 以 使 用 新 块 的 情况 ， 将 在 后 面 的 章节 详细 ， 如 "控制 流 "。 


如 何 缩 进 缩 进 只 使 用 4 个 空格 ， 这 是 Python 官方 推荐 的 标准 。 好 的 编辑 器 会 为 你 自动 这 
样 做 。 确 保 你 使 用 一 致 的 数量 的 缩 进 空格 ， 和 否则 你 的 程序 将 显示 错误 。 


静态 语言 程序 员 应 注意 Python 为 块 总 是 使 用 缩 进 ， 从 来 不 用 花 括 号 。 运 行 from 


__future__ import braces 可 以 了 解 更 多 ss 


小 结 


现在 ， 我 们 已 经 经 历 了 许多 细节 ,我 们 可 以 转 到 更 有 趣 的 东西 ， 如 控制 流 语句 。 一 定 要 熟悉 这 
一 章 你 所 读 的 。 


继续 阅读 操作 符 和 表达 式 


RUE Ft HP RIK AK 


你 编写 的 大 多 数 语句 (逻辑 行 ) 都 将 包含 表达 式 。 一 个 表达 式 的 简单 例子 是 2+3 。 一 个 表达 
式 可 分 解 成 操作 符 和 操作 对 象 。 

操作 符 的 功能 是 做 一 些 事 ， 通 过 符号 (如 + ) 或 特定 的 关键 字 表 示 。 操 作 符 需要 一 些 数据 来 
操作 ， 这 些 数据 被 你 作 操 作对 象 。 在 这 个 例子 中 2 和 3 是 操作 对 象 。 


操作 对 象 


我 们 将 简单 地 看 一 下 操作 符 和 它 的 用 法 : 


注意 ， 您 可 以 使 用 交互 式 解释 器 计算 例子 中 给 出 的 表达 式 。 例 如 ,为 了 测试 表达 式 2 + 3 ° 1% 
用 交互 式 Python 解 释 器 提示 符 : 


以 下 是 一 些 操作 符 的 简介 : 
@ + (加 号 ) 


o 两 个 对 象 相 加 
o 3+5 4% 8° 'a'+'b' 得 'ab'。 
。 - ( 减 号 ) 
o 给 出 一 个 数 减 去 另 一 数 的 差 ; 如 果 缺 少 第 一 个 操作 数 ， 它 默认 为 是 0。 
o -5.2 得 到 一 个 负数 ，50 - 24 得 26. 


T2 
e > (乘法 ) 


o 给 出 两 个 数 的 乘积 或 返回 重复 多 次 的 字符 串 。 
o 2*3 得 6. 'la' * 3 得 到 ‘lalala' . 
e 火炎 (7) 
o 3A Exhgyk 
o 3**4 得 81 (也 就 是 3*3*3*3) 


。 / (除法 ) 


> 


o X 除 以 y 


O RRT 得 4.3333333333333333 . 
// (整除 ) 


o 返回 最 大 的 整数 商 
o 13//3 + 4 

o -13//3 得 -5 
% ( 取 模 ) 


o 返回 除法 的 余数 
co EE 和 El. Sse 行 Ee. 


< (向 左 移 位 ) 


o 数字 向 左 移动 指定 位 数 。( 在 内 存 中 每 个 数字 由 比特 或 二 进 制 数 表示 ， 例 如 : 0 和 


1) 。 
o 2<<2 得 8 .2 用 二 进 制 表示 为 10 © 
o AAS ALES] 1000 ， 它 表示 数字 8 ° 
> (向 右 移 位 ) 


$ 


。 数字 向 右 移动 指定 位 数 。 


o li 5. 


o 1 用 二 进 制 表示 为 1011 ， 向 右 移动 1 位 后 得 到 二 进 制 101 ， 表 示 数 字 5 。 


& Ll 
o 数字 的 按 位 与 


o 5&3 得 1。 

| ( 按 位 或 ) 

o 数字 的 位 相 或 

o 513 得 7。 

n ( 按 位 异 或 ) 

o 数字 的 位 相 异 或 

o 5^3 得 6。 

- ( 按 位 求 反 ) 

o X 的 位 求 反 结果 为 -(X+1) 
o -5 得 -6 。 详 见 http://stackoverflow.com/a/11810203 
< (小 于 ) 


o 返回 X 是 否 小 于 y。 所 有 的 比较 运 去 算 符 返 回 True 或 False ° 注意 & 这 些 
o 5<3 返回 False 而 3<5 返回 True. 
o 比较 运算 符 可 以 任意 连接 : 3<5<7 返回 true. 


字 的 大 小 写 


o 5>3 返回 True 。 如 果 操 作对 象 都 是 数字 ， 它 们 首先 转换 为 普通 型 ， 否 则 ， 将 返 


。 =: (FF) 


o 比较 操作 对 象 是 否 相 等 
o x=2;y=2; x= y 返回 True. 


M = y R EY 
o x= ‘str’: 2 Istri: x == y 返回 True . 


e != (AFT) 


。 比较 操作 对 象 是 否 不 相等 
x=2;y=3;x!=y AE True. 
© not (逻辑 非 ) 


o 如 果 X 是 True , 它 返 回 False 。 如 果 X 是 False °? CAE True ° 
= True; not x 返回 False. 


o 如果 X 是 False, x andy 返回 False ， 否 则 它 返 回 y 的 值 。 
o x= False; y = True; x andy 返回 False ， 因 为 x 为 假 。 在 这 种 情况 下 ，Python 
将 不 计算 y， 因 为 它 知 道 and 左边 表达 式 是 False ， 这 意味 着 整个 表达 式 将 为 
False ， 而 不 论 其 它 值 为 什么 。 这 叫做 求 值 捷径 。 
e or (逻辑 或 ) 


o 如 果 X 为 True, 它 返回 真 ， 否 则 它 返 回 y 的 值 。 
o x= True; y = False; x or y 返回 true 。 求 值 捷径 这 也 适用 。 


数学 操作 和 赋值 的 快捷 方式 


我 们 经 常会 对 一 个 变量 进行 数学 操作 ， 然 后 将 操作 的 结果 返回 给 最 初 的 变量 。 这 些 表达 式 有 
一 个 快捷 方式 : 


可 以 写成 : 


S y P œ 5 A 
ER: 将 var = var operation expression 写成 var operation= expression ° 


N= 


运算 顺序 


如 果 你 有 一 个 表达 式 如 2 + 3 * 4， 是 先 做 加 法 还 是 先 做 乘法 呢 ? 我 们 的 高 中 数学 告诉 我 们 ， 
应 该 先 做 乘法 。 这 意味 着 乘法 操作 符 比 加 法 操作 符 具 有 更 高 的 优先 级 。 


下 面 的 表 给 出 了 Python 运算 顺序 的 优先 表 ， 从 最 低 (最 小 约束 力 ) 到 最 高 (最 高 约束 力 )。 意 
思 是 说 ， 在 给 定 的 表达 式 中 ，Python 将 按照 自 下 而 上 的 顺序 ， 首 先 计算 优先 表 下 方 的 表达 
式 。 


下 面 的 表 取 自 Python 参 考 手册 ， 是 为 了 提供 完整 性 。 为 了 显 式 地 指定 优先 级 ， 更 好 的 做 法 是 
使 用 圆 括 号 组 织 运算 符 和 操作 对 象 。 这 可 使 程序 更 加 可 读 。 详 见 下 面 更 改 运 算 顺 序 。 


e lambda :Lambda 表 达 式 

@ if - else : 条 件 表达 式 

@ or : 逻辑 或 

e and : 2H 

e not x : 逻辑 非 

e in, not in, is, is not, <, <=, >, >=, !=, == :上 比较、 成 员 检测 、 相 等 检测 
e | : 按 位 或 

© n : 按 位 异 或 

e & : 按 位 与 

e <<, >> : 移 位 

e +，- PPR 

e = /, //,% :乘法 ， 除 法 ， 浮 点 除 和 余数 
© +X, -x, ~X : 正 ， 负 按 位 非 


e x[index], x[index:index], x(arguments...), x.attribute : 索引 ， 切 片 ， 函 数 调 用 ， 属 
性 引用 
e (expressions...), [expressions...], {key: value...}, {expressions...} :显示 Binding 


或 元 组 ， 显 示 列 表 ， 显示 字典 
我 们 没有 遇 到 的 操作 符 将 在 后 面 的 章节 解释 。 


上 表 中 在 同一 行列 出 的 操作 符 具 有 相同 优先 级 。 例 如 ，+ 和 - 具有 相同 的 优先 级 。 


改变 运算 顺序 


为 使 表达 式 更 具 可 读 性 ， 我 们 可 以 使 用 圆 括号 。 例 如 2 + (3 * 4) 肯定 比 需要 知道 操作 符 运 
算 优 先 级 的 2 + 3 * 4 更 容易 理解 。 与 其 他 方面 一 样 ， 应 该 合理 使 用 括号 不 应 该 宛 余 (不 要 过 
分 使 用 ), 如 (2 + (3 * 4)) ° 


使 用 括号 有 一 个 额外 的 优势 一 一 它 帮 助 我 们 更 改 运 算 顺 序 。 例 如 ， 如 果 您 想 要 在 一 个 表达 式 
中 加 法 在 乘法 之 前 运算 ， 那 么 你 可 以 这 样 写 (2 + 3) * 4 ° 


结合 性 


操作 符 通常 从 左 到 右 。 这 意味 着 具有 相同 优先 级 的 操作 符 从 左 到 右 的 方式 计算 。 例 如 2 + 3 + 
4 计算 为 (2+3)+4 ° 


REA 


例子 (保存 为 expression.py): 


length = 5 
breadth = 2 


area = length * breadth 
print('Area is', area) 
print('Perimeter is', 2 * (length + breadth) ) 


输出 : 


D:> python expression.py 
Area is 10 
Perimeter is 14 


它 是 如 何 工 作 的 


给 形 的 长 度 和 宽度 以 同样 的 名 字 存 储 在 变量 中 ， 在 表达 式 的 帮助 下 ， 我 们 使 用 这 些 计算 矩形 
的 面积 和 周 长 。 我 们 存储 表达 式 length * breadth 的 结果 在 变量 area 中 ， 然 后 使 用 print 函 数 
打印 它 。 在 第 二 种 情况 下 ,在 打印 函数 中 我 们 直接 使 用 表达 式 2 * (length + breadth) 的 值 。 


同样 要 注意 ，Python 完 美 打印 是 如 何 输出 的 。 即 使 我 们 没有 在 'Area is! 和 变量 area ,之 间 
指定 一 个 空间 ，Python 为 我 们 得 到 一 个 干净 漂亮 的 输出 ， 而 且 这 种 方式 使 用 程序 的 可 读 性 更 
强 (因为 我 们 不 需要 担心 为 输入 我 们 在 字符 串 中间 使 用 的 空格 )。 这 只 是 让 Python 程序 员 的 生活 
更 轻松 的 一 个 例子 。 


小 结 


我 们 已 经 看 到 了 如 何 使 用 操作 符 ， 操 作对 象 和 表达 式 
将 看 到 在 使 用 语句 的 程序 中 如 何 利 用 这 些 。 


这 是 任何 程序 的 基石 。 接 下 来 ,我 们 





继续 阅读 控制 流 


控制 流 


在 程序 中 ， 到 现在 为 止 ， 我 们 看 到 ， 一 直 有 一 系列 的 语句 被 Python 以 由 上 而 下 的 顺序 如 实地 
执行 。 如 果 你 想 改 变 它 的 流程 ， 它 会 如 何 工作 呢 ? 例如 ， 你 想 让 程序 作出 一 些 决定 ， 而 且 不 
同 的 情况 做 不 同 的 事情 ， 例 如 ， 根 据 一 天 的 时 间 不 同 ， 打 印 早上 好 或 晚上 好 ? 


正如 你 可 能 已 经 猜 到 的 ， 这 要 通过 使 用 控制 流 语句 。 在 Python 中 有 三 个 控制 流 语句 -- if, 
for 和 while ° 


if 7% 4) 


if 73 4) eA REA HS A te RAE BT EAT AAE 27 RUE APR) > SM BMA A 
个 语句 块 ( 称 为 else 块 )。else 语 名 是 可 选 的 。 


例如 (保存 为 ifpy): 


number = 23 
guess = int(input(' 请 输入 一 个 整数 : ')) 


if guess == number: 
# 新 块 从 这 里 开始 
print(' 茶 喜 ， 你 猜 对 了 。') 
print(' (但 你 没有 获得 任何 奖品 ! )') 
# 新 块 在 这 里 结束 
elif guess < number: 
# APR 
print(' 不 对 ， 你 猿 的 有 点 儿 小 ') 
# TE — PBR PRT ABR ET E 
elise): 
print(' 不 对 ， 你 猜 的 有 点 大 ') 


# 你 猜 的 数 比 number 大 时 才能 到 这 里 


print(' 完 成 ') 


# if 语 句 执行 完 后 ， 最 后 的 语句 总 是 被 执行 





$ python if.py 
请 输入 一 个 整数 : 50 
不 对 ， 你 猜 的 有 点 儿 大 


$ python if.py 
请 输入 一 个 整数 ; 22 
不 对 ， 你 猜 的 有 点 儿 小 


$ python if.py 

请 输入 一 个 整数 : 23 
恭喜 ， 你 猜 对 了 。 

(但 你 没有 获得 任何 奖品 ! ) 
完成 


它 是 如 何 工作 的 : 


在 这 个 程序 中 ， 我 们 获取 来 自用 户 的 猜测 ， 并 检查 这 个 数 是 否 是 我 们 设 定 的 数 。 我 们 给 变量 
number 设 置 我 们 想 要 的 任何 整数 ， 比 如 23 。 然 后 ， 我 们 使 用 inuto 函数 获取 用 户 的 猜 的 
数 。 函 数 是 可 重用 的 程序 块 。 我 们 在 下 一 章 中 会 阅读 关于 它们 的 更 多 东西 。 


我 们 给 内 置 的 input 函数 提供 一 个 字符 串 ， 该 函数 将 其 打印 到 屏幕 上 并 等 待 用户 输 入 。 一 旦 
我 们 输入 一 些 东西 并 按 下 回 车 键 ， input() 函数 把 我 们 的 输入 作为 一 个 字符 串 返回 。 然 后 ， 
我 们 使 用 int 将 这 个 字符 串 转 换 为 整数 ， 然 后 将 其 存储 在 变量 guess 中 。 实 际 上 ， int 是 一 
个 类 ， 但 现在 所 有 你 需要 知道 的 是 ， 您 可 以 使 用 它 来 将 一 个 字符 串 转 变 为 一 个 整数 (假设 文本 
中 的 字符 囊 包 含 一 个 有 效 的 整数 )。 

接 下 来 ,我 们 比较 用 户 猜 的 数 和 我 们 选择 的 数 ， 如 果 他 们 相等 ， 我 们 打印 一 条 成 功 的 消息 。 注 
意 ， 我 们 使 用 缩 进 级 别 告诉 Python 语句 属于 哪个 块 。 这 就 是 为 什么 缩 进 P 在 ython 中 是 如 此 重 
要 。 我 希望 你 坚持 "一 致 的 缩 进 " 的 规则 ， 好 吗 ? 

注意 ，if 语句 在 最 后 有 一 个 冒号 一 一 我 们 指示 Python 一 个 语句 块 将 跟随 其 后 。 

然后 ,我 们 检查 猜 的 数 是 否 小 于 这 个 数字 ， 如 果 是 ， 我 们 通知 用 户 ， 他 们 猜 的 数 必须 比 那 个 数 
稍 高 。 我 们 这 里 使 用 的 是 elit 子 甸 ， 实 际 上 将 两 个 相关 的 if else-if else 语 名 组 合 为 一 个 
语句 if-elif-else ， 这 使 程序 更 简单 且 减 少 所 需要 的 缩 进 s 

elif 和 else 语句 也 必须 在 逻辑 行 结 束 时 有 一 个 冒号 ， 后 跟 相 应 的 语 铝 块 (当然 要 通过 适 当 的 
缩 进 ) 


你 可 以 在 it 语句 的 if RPA A it 语句 这 称 为 if HARA © 





记 住 ， elif 和 else 部 分 是 可 选 的 。 一 个 最 小 的 有 效 的 if 语句 是 : 


if True: 
print('2% > GAB") 


在 Python 执 行 完成 完整 的 if 语 句 以 及 相关 的 elif 和 else FA CHM if 包含 语句 的 块 中 
下 一 个 语句 块 。 在 本 例 中 ， 它 是 主要 的 块 (程序 开始 执行 的 地 方 )， 接 下 来 的 语句 是 print(' 完 
R) 。 在 这 之 后 ，Python 将 看 到 程序 的 结尾 ， 并 简单 的 完成 。 


尽管 这 是 一 个 非常 简单 的 程序 ， 但 你 应 该 注意 ， 我 已 经 指出 很 多 东西 。 所 有 这 些 都 是 相当 的 
直截了当 (对 那些 有 C/C++ 背景 的 人 是 惊人 的 简单 )。 最 初 ， 你 需要 意识 到 所 有 这 些 事情 ,但 经 
过 一 些 练习 ， 对 它们 你 将 感到 舒服 ， 自 然 将 是 你 所 有 的 感觉 。 


C/C++ 程 序 员 需要 注意 在 Python 中 没有 switch 语句 。 您 可 以 使 用 一 
个 if..elif..else 语句 做 同样 的 事 ( 和 在 茶 些 情况 下 ,使 用 词典 去 做 更 快速 ) 


while7é 4) 


REAPAB > while 语句 允许 您 多 次 执行 一 个 语句 块 。 while 语句 是 被 称 为 循环 语句 的 一 


JN 


种 。While 语 多 可 以 有 一 个 可 选 的 else FA o 


例如 (保存 为 while.py): 


number = 23 
running = True 


while running: 
guess = int(input(' 输 入 一 个 整数 : ')) 


if guess == number: 
print(' 茶 喜 ， 你 猜 对 了 。') 
# 这 使 While 循 环 停止 
running = False 
elif guess < number: 
print(' 不 对 ， 你 猜 的 有 点 儿 小 。') 
elise; 
print(' 不 对 ， 你 猜 的 有 点 儿 大 。') 
elise: 
print('while 循 环 结束 。' ) 
# 在 这 做 你 想 做 的 任何 事 


print( ' 完 成 ' ) 


输出 : 


$ python while.py 
输入 一 个 整数 : 50 
不 对 ， 你 猿 的 有 点 儿 大 。 
输入 一 个 整数 : 22 
不 对 ， 你 猜 的 的 点 儿 小 。 
输入 一 个 整数 : 23 
恭喜 ， 你 猜 对 了 。 
while 循 环 结束 。 





它 是 如 何 工作 的 : 

在 这 个 程序 中 ， 我 们 还 是 玩 猜 囊 游戏， 但 优点 在 于 ， 允 许 用 户 一 直 猜 直到 他 猜 对 每 次 猎 
测 不 需要 重复 运行 该 程序 ， 正 如 我 们 在 前 一 节 中 所 做 的 。 这 演示 了 如 何 恰当 的 使 用 while 语 
a] o 





我 们 移动 input 和 if 语句 到 while 循环 中 ， 在 while 循环 前 ， 设 置 变 

量 running 为 True 。 首 先 ， 我 们 检测 变量 running 是 否 为 True ， 然 后 往 下 执行 相应 的 while 
块 。 在 这 个 块 执 行 完 后 ， 再 检测 条 件 ， 在 这 里 是 变量 running 为 披 ， 我 们 再 次 执行 while 块 ， 
否则 ， 我 们 执行 可 选 的 else 块 ， 然 后 执行 下 面 的 语句 。 


当 while IRJIEH False 时 -- 这 也 可 能 发 生 在 条 件 检 测 时 的 第 一 次 ， 执 行 else 块 。 如 
果 你 使 用 break 语句 退出 循环 的 话 ， 那 么 else 子 句 就 不 会 被 执行 ， 否 则 当 while 循环 的 条 
件 变 为 False 时 就 会 执行 。 


在 这 里 True 和 False 被 称 为 布尔 类 型 ， 你 可 以 认为 它们 分 别 相 当 于 值 1 和 6 。 


C/C++ 程序 员 注 意 : 记 住 ，while 循 环 可 以 有 else 子 句 。 


for 循环 


for..in 语句 是 另 一 个 循环 语句 ， 它 迭代 一 个 对 象 的 序列 ， 例 如 经 历 序列 中 的 第 一 项 。 在 后 
面 的 章节 ， 我 们 将 会 看 到 更 多 关于 序列 的 细节 。 现 在 ， 你 需要 知道 的 是 一 个 序列 只 是 一 个 有 
序 的 项 目的 集合 。 


例如 (保存 为 for.py): 
for i in range(1, 5): 
print(i) 


else: 
print('for 循 环 结束 ' ) 


输出 : 


$ python for .py 
1 

2 

3 

4 

for 循 环 结束 


它 是 如 何 工作 的 : 
打印 一 个 数字 序列 。 我 们 使 用 内 置 的 range 函数 生成 这 个 数字 序列 。 


我 们 在 这 文 里 所 做 的 是 提供 两 个 数字 ” range 返回 一 个 从 第 一 个 数字 到 第 二 个 数字 的 一 个 数字 
序列 © 例如 ， range(1, 5) ? 合 出 序列 [ 2 S l ° 默认 情况 下 ? range 步 长 值 为 1 。 如果 我 
们 为 range 函数 提供 第 三 个 参数 ， 那 么 它 这 个 参数 就 是 新 的 步 长 值 。 例 如 range(1,5,2) 得 
到 [1，3] 。 请 记 住 ， 数 字 的 范围 不 超过 第 二 个 参数 的 值 ， 即 它 不 包括 第 二 个 数字 。 


注意 意 ， range() 生成 一 个 数字 序列 ? 在 for 循 环 中 它 一 次 只 生成 一 个 数字 。 如 果 你 想 立刻 看 到 完 
整 的 数字 序列 ,使 用 list(range()) 。 例 如 , for example，list(range(5)) 会 输出 [6，1，2，3， 
4] 。list( 列 表 ) 将 在 数据 结构 中 解释 。 


for 循环 然后 遍历 这 个 范围 ， for i in range(1,5) 相当 于 for i in lp Ae Sy Col ? 这 就 像 
把 序列 中 的 每 一 个 数 (或 对 象 ) 分 配给 i ， 一 次 一 个 ， 然 后 为 每 个 i 值 执行 该 语句 块 。 在 本 例 
中 ， 在 语句 块 中 我 们 只 eee. 


记 住 ， else 部 分 是 可 选 的 。 当 包括 它 时 ， 除 非 遇 到 break 语 名 ， 当 for 循 环 结 束 时 ， 它 执行 一 


记 住 ， for..in 循环 可 以 作用 于 任何 序列 。 在 这 里 ， 我 们 对 一 个 由 内 建 的 range 函数 生成 的 
一 个 数字 列表 ， 但 是 一 般 来 说 ， 我 们 可 以 使 用 任何 种 类 对 象 的 任何 类 型 的 序列 ! 在 后 面 的 章 
节 ， 我 们 将 详细 探讨 这 个 想法 。 


C/C++/Javal/C# 程 序 要 注意 Python 的 for 循环 完全 不 同 于 C/C++ 的 for 循环 。C# 程 序 
员 会 注意 到 ， Python? for 循环 类 似 于 C# 中 的 foreach 循环 。Java 程 序 员 会 注意 到 ， 
也 类 似 于 在 Java 1.5 中 的 for (int i : IntArray) ° 


在 C/C++ 中 ， 如 果 你 想 写 for (int i = 0; i < 5; i+) ， 那 么 在 Python 中 你 只 要 写 for i 
in range(0, 5) 。 正 如 您 可 以 看 到 的 ,在 Python 中 for 循环 更 简单 ， 更 富有 表现 力 且 不 多 
出 错 。 


breakié 4) 


break 语句 是 用 来 跳出 一 个 循环 语句 ， 即 停止 执行 一 个 循环 语句 ， 即 使 循环 条 件 还 没有 成 
为 False 或 序列 的 项 目 没有 被 完全 遍历。 


很 重要 的 一 点 是 ， 如 果 你 跳出 for 或 while 循环 ， 任 何 相应 的 循环 else 块 是 不 执行 的 。 


例子 (保存 为 break.py): 


while True: 
s = input(' 输 入 一 些 东 西 : ') 
if s == 'quit': 
break 
print(' 字 符 囊 的 长 度 是 '，len(s)) 
print(' 完 成 ') 


输出 : 


$ python break.py 

输入 一 些 东 西 : Programming is fun 

字符 串 的 长 度 是 18 

输入 一 些 东 西 : When the work is done 

字符 串 的 长 度 是 21 

输入 一 些 东 西 : if you wanna make your work also fun: 
字符 串 的 长 度 是 37 

输入 一 些 东 西 : use Python! 

符 串 的 长 度 是 12 

输入 一 些 东 西 : quit 





4y 





它 是 如 何 工 作 的 : 


在 这 个 程序 中 ， 我 们 重复 获取 用 户 输入 的 东西 并 打印 每 次 输入 字符 串 的 长 度 。 我 们 提供 一 个 
特殊 的 条 件 -- 通 过 检查 用 户 输入 是 否 是 quit 来 结束 程序 。 我 们 通过 跳出 循环 停止 程序 ， 达 到 
该 程序 的 结束 位 置 。 


输入 字符 串 的 长 度 可 以 使 用 内 建 的 len HA o 
记 住 ， break 语句 同样 适用 于 for 循环 。 
Swaroop 的 诗意 的 Python 


编程 自 有 磊 如 玉 

每 当 工作 完成 时 

如 你 也 想 颜 如 王 : 
使 用 Pythonl 


continue? 4 


continue 语句 是 用 来 告诉 Python 跳 过 过 


例子 (保存 为 continue.py): 


while True: 
s = input(' 输 入 一 些 东西 : ') 
if s == 'quit': 
break 
if len(s) < 3: 
print(' 太 小 ') 
continue 
print(' 输 入 的 东西 有 足够 的 长 度 ' ) 


+ 3x te Hon A kh Ah FH 
t 在 这 做 其 它 各 种 处 理 ,, ， 


输出 : 


$ python continue. py 
输入 一 些 东西 : a 

太 小 

输入 一 些 东 西 : 12 

Kp 

输入 一 些 东西 : abc 
输入 的 东西 有 足够 的 长 度 
输入 一 些 东西 ; quit 





是 如 何 工 作 的 : 


在 这 个 程序 中 ， 我 们 接受 来 自用 户 的 输入 ， 


Eee 
我 们 跳 过 块 中 的 其 余 语句 。 否 则 ， 在 循环 中 的 其 余 语句 将 被 执行 -- 在 这 人 


注意 ， continue 语句 同样 适用 于 for 循环 。 
小 结 

我 们 已 经 看 到 了 如 何 使 用 三 个 控制 
点 。 


接 下 来 ， 我 们 将 学 习 如 何 创建 和 使 用 函数 。 


继续 阅读 函数 


当前 循环 块 中 其 余 的 语句 ， 继 续 循 环 的 下 一 次 迭代 。 


只 有 在 输入 的 字符 串 至 少 有 3 个 字符 时 才 处 
， 如 果 长 度 度 小 于 3 2 通过 使 用 continue aJ 2 
数 其 它 各 种 处 理 。 


讽 语 名 -- if © while 和 for 以 及 与 它们 相关 的 
break 和 continue 语句 。 由 于 这 ee Python 最 常用 的 部 分 


你 需要 尽快 和 他 们 混 得 熟 一 
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函数 是 可 重用 的 程序 片段 。 你 可 以 给 一 块 语句 一 个 名 字 ， 并 且 在 你 的 程序 的 任何 地 方 使 用 指 
定 的 名 字 和 运行 任何 次 数 。 这 就 是 所 谓 的 函数 调用 。 我 们 已 经 使 用 了 许多 内 置 函数 
如 len 和 range ° 
在 任何 有 价值 软件 中 ， 函 数 的 概念 都 是 最 重要 的 基础 (对 于 任何 编程 语言 都 一 样 )， 所 以 ， 在 这 
一 章 ， 我 们 将 探索 函数 的 各 各 方面 。 
定义 函数 使 用 def 关键 字 。 在 这 个 关键 字 之 后 是 标识 函数 的 名 字 ， 其 次 是 在 一 对 括号 中 可 以 
附 上 一 些 变量 名 ， 最 后 在 行 的 末尾 是 冒号 。 接 下 来 是 语 多 块 -- 函 数 的 内 容 。 一 个 例子 将 展示 这 
些 ， 这 实际 上 是 非常 简单 的 : 
例子 (保存 为 function1.py): 

def sayHello(): 


函数 的 语句 块 


print(' 世 界 您 好 !') 


sayHello() # 调用 函数 
sayHello() # 再 次 调用 函数 


输出 : 


$ python function1.py 
世界 您 好 ! 
世界 您 好 ! 


它 是 如 何 工 作 的 : 


我 们 使 用 上 述 的 语法 ， 定 义 了 一 个 称 为 sayHello 函数 。 这 个 函数 没有 参数 ， 因 此 没有 在 圆 括 
号 中 声明 变量 。 了 有 函数 的 参数 只 是 输入 到 函数 中 ， 以 便 我 们 可 以 给 它 传递 不 同 的 值 返回 相应 的 
结果 。 


注意 ， 我 们 可 以 调用 相同 的 函数 两 次 ， 这 意味 着 我 们 不 需要 再 写 同样 的 代码 。 


Ph Hk Hy HBL 


一 个 函数 可 以 带 参 数 -- 你 提供 给 函数 的 值 ， 利用 这 些 值 该 函数 可 以 做 一 些 事情 。 这 些 参数 就 像 
变量 ， 所 不 同 的 是 当 我 们 调用 函数 时 这 些 变量 eae 被 定义 ， 当 前 数 运行 时 ， 它 们 已 经 有 
了 指定 的 的 值 。 


参数 是 在 函数 定义 中 在 一 对 括号 中 指定 ， 之 间 用 过 号 分 隔 。 当 我 们 调用 这 个 函数 ， 我 们 以 同 
样 的 方式 提供 这 些 值 。 注 意 使 用 的 术语 在 函数 的 定义 中 给 出 的 名 字 叫 形 参 ， 而 在 函数 调 
用 时 您 提供 的 值 被 称 为 实 参 。 





例子 (保存 为 func_param.py): 


def printMax(a, b): 
if a > b: 
print(a, 'A') 
elif a = b: 
print(a, '#T', b) 
else: 
print(b, 'A') 


上 接 给 由 
E 4&0 2 3 i ti El 


a 4) 


X = 5 
yY 
给 出 $e # 的 i = 


Dennen ce y) 


输出 : 


$ python func_param.py 
4 大 
UR 


它 如 何 工作 的 : 


在 这 里 ， 我 们 定义 了 一 个 称 为 printMax 4 BR? CMA a 和 b 的 两 个 参数 。 我 们 使 用 简单 
的 if..else 语句 找 出 比较 大 的 数 ， 然 后 打印 较 大 的 数 。 


我 们 第 一 次 调用 函数 printMax ， 我 们 直接 提供 了 数字 作为 参数 。 在 第 二 种 情况 下 ， 我 们 调用 
BBA REA BR © printMax(x，y) 把 实 参 x 分 配给 形 参 a > y 分 配给 bp 。 在 这 两 种 
情况 下 ， printMax 函数 以 同样 方式 工作 。 


局 部 变量 


你 在 子 数 定义 中 声明 的 变量 ， 他 们 与 在 函数 外 使 用 的 其 它 同名 变量 没有 任何 关系 ， 即 变量 名 
称 对 函数 来 说 是 局 部 的 。 这 叫 变 量 的 范围 。 所 有 变量 都 有 它们 被 声明 的 块 的 范围 ， 从 名 称 定 
义 的 点 开始 。 


例子 (保存 为 func local.py): 


X = 50 


def func(x): 
print('x#T', x) 
eS 2 
print(' 局 部 变量 x 改变 为 '，X) 


func(x) 
print('x—-Hz', x) 


输出 : 


$ python func_local.py 
x T50 

局 部 变量 X 改 变 为 2 

x 一 直 是 50 


它 是 如 何 工 作 的 : 


第 一 次 ， 我 们 使 用 函数 体 中 第 一 行 打印 变量 X 的 值 ，Python 使 用 在 主 块 中 ， 函 数 定义 上 声明 的 
KH 


接 下 来 ， 我 们 给 x 赋值 为 2 > BEA x 对 我 们 的 函数 来 说 是 局 部 变量 ， 因 此 在 函数 中 当 我 
们 改变 x 的 值 时 ， 在 主 块 中 定义 的 变量 x 不 受 影响 。 
最 后 调用 的 print 函数 ， 显 示 在 主 块 中 定义 的 变量 x ， 说 明 它 不 受 在 前 面 调用 函数 的 局 部 变 


量 的 影响 。 


使 用 全 局 声明 


如 果 你 想 给 在 顶层 的 程序 ( 即 未 在 任何 函数 或 类 之 中 ) 定 义 的 变量 赋值 ,那么 你 必须 告诉 
Python， 变 量 不 是 局 部 的 ， 而 是 全 局 的 。 我 们 使 用 global 1 4) > HA global 语句 赋值 给 一 
个 在 函数 外 定义 的 变量 是 不 可 能 的 。 


您 可 以 使 用 这 些 在 函数 外 定义 的 变量 的 值 (假设 在 函数 内 没有 同名 的 变量 )。 然 而 ， 这 并 不 鼓 
励 ， 应 该 避免 ， 因 为 这 使 程序 的 读者 不 清楚 变量 是 在 哪里 定义 的 ， 使 用 global 语句 就 非常 
清楚 ， 变 量 定义 在 一 个 最 外 的 块 中 。 


例子 (保存 为 func global.py): 


X = 50 


def func(): 
global x 


print('xX 的 值 是 '，X) 

X= 这 

print( 全 局 变量 X 改 为 x) 
func() 


print('xX 的 值 是 '，X) 


输出 : 


$ python func_global.py 
X 的 值 是 59 

全 局 变量 to 改 为 2 

X 的 值 是 2 


它 是 如 何 工作 的 : 


global 语句 用 来 声明 x 是 全 局 变量 ， 当 我 们 在 函数 内 给 x 赋值 时 ， 它 的 改变 映射 到 我 们 在 
主 块 中 使 用 的 x 的 值 。 


用 同样 的 global 语句 可 以 指定 多 个 全 局 变量 ， 比 如 : global x, y, z ° 


参数 默认 值 


对 于 一 些 函 数 ， 你 可 能 想 要 一 些 参数 是 可 选 ， 即 在 用 户 不 希望 为 它们 提供 值 时 使 用 默认 值 ， 
这 在 默认 的 参数 值 的 帮助 下 完成 的 。 你 可 以 在 函数 定义 中 通过 在 参数 名 称 后 使 用 赋值 操作 符 
( = ) 后 跟 默 认 值 来 指定 默认 的 参数 值 。 


注意 ， 默 认 参 数值 应 该 是 一 个 常数 。 更 准确 的 说 ， 默认 的 参数 值 应 该 是 不 可 变 的 一 一 这 在 后 
面 的 章节 中 做 了 详细 解释 。 现 在 ， 只 要 记 住 这 点 。 


例子 (保存 为 func_default.py): 


def say(message, times = 1): 
print(message * times) 


say(' 你 好 ') 
say(' 世 界 '，5) 


输出 : 


$ python3 func_default.py 
你 好 
世界 世界 世界 世界 世界 





它 是 如 何 工 作 的 : 


函数 say 是 用 来 按照 指定 的 次 数 打印 一 个 字符 串 。 如 果 我 们 不 提供 一 个 值 ， 那 么 在 默认 情 
下 字符 串 只 打印 一 次 。 为 此 ， 我 们 为 参数 times 指定 一 个 默认 参数 值 1。 

在 第 一 次 使 用 函数 say 时 ， 我 们 只 提供 了 字符 串 ， 它 打印 字符 串 一 次 。 在 第 二 次 使 

用 say 时 ， 我 们 提供 了 字符 串 和 一 个 实 参 5 两 个 参数 ， 说 明 我 们 想 要 say 字符 串 5 次 。 


重要 提示 只 有 在 参数 列表 后 面 的 的 参数 可 以 被 赋予 默认 参数 值 ， 即 在 参数 列表 中 ， 你 不 
能 在 没有 默认 值 的 参数 前 有 有 默认 参数 值 的 参数 。 这 是 因为 ， 值 按 位 置 分 配给 参数 。 例 
如 ， def func(a, b=5) 是 有 效 的 ， 而 def func(a=5, b) 是 无 效 的 。 


如 果 你 有 一 些 有 许多 参数 的 函数 ， 您 想 要 指定 参数 中 的 一 些 ， 那 么 ， 你 可 以 通过 为 参数 命名 
来 为 它们 赋值 一 一 这 叫做 参数 关键 字 一 一 我 们 使 用 名 称 (关键 字 ) 而 不 是 位 置 (我 们 一 直 使 用 的 ) 
来 指定 函数 的 参数 。 


这 有 两 个 优势 ， 一 是 ， 使 用 函数 容易 ， 因 为 我 们 不 需要 担心 参数 的 顺序 。 二 是 ， 如 果 其 他 参 
数 有 默认 参数 值 ， 我 们 可 以 只 给 我 们 想 赋 值 的 参数 赋值 。 


例子 (保存 为 func_key.py): 


def func(a, b=5, c=10): 
print('a¥', a, '#bA', b, 'fecA', c) 


func(3, 7) 


func(25, c=24) 
func(c=50, a=100) 


输出 : 


$ python func_key.py 
a 为 3 和 b 为 7 和 c 为 10 
a 为 25 和 b 为 5 和 Cc 为 24 
a 为 100 和 b 为 5 和 Cc 为 50 


它 是 如 何 工 作 的 : 


名 为 func 的 部 数 中 有 一 个 参数 没有 默认 参数 值 ， 后 面 两 个 参数 有 默认 参数 值 。 


第 一 次 使 用 func(3，7) ， 参 数 a 得 到 值 3 ， 参 数 b 得 到 值 7 > KR c 得 到 默认 值 10 © 


第 二 次 使 用 func(25，c=24) ,参数 a 按照 参数 的 位 置 得 到 值 25 ， 然 后 参数 c 按照 参数 名 ， 


也 就 是 参数 关键 字 ， 得 到 值 24 > BE b 得 到 默认 值 o 


第 三 次 使 用 func(c=50, a=100) ， 我 们 为 所 有 给 定 的 值 使 用 了 参数 关键 字 。 注 意 ， 我 们 为 参 


数 c 指定 值 是 在 参数 a 之 前 ， 尽 管 在 函数 定义 中 ac We 
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变量 参数 
有 时 你 可 能 想 定义 一 个 函数 ， 它 可 以 获取 参数 的 任何 值 ， 这 可 以 通过 使 用 星 号 (另存 为 total.py) 
实现 


def total(a=5, *numbers, **phonebook): 
print('a', a) 

元 组 遍历 全 部 的 参数 

for single_item in numbers: 
print('single_item', single_item) 

# 通 过 字典 遍历 全 部 的 参数 

for first_part, second_part in phonebook.items(): 
print(first_part, second_part) 


print(total(10,1,2,3, Jack=1123, John=2231, Inge=1560) ) 


输出 : 


$ python function_varargs.py 
a 10 

single_item 1 

single_item 2 

single_item 3 

Inge 1560 

John 2231 

Jack 1123 

None 


它 是 如 何 工 作 的 : 


当 我 们 声明 一 个 星 号 的 参数 ， 如 *param > PAMAR—BRABAZ 吉 束 的 所 有 位 置 的 参数 都 被 收 


集 到 一 个 叫 param 的 元 组 中 。 


同样 , 当 我 们 声明 一 个 双星 参数 ， 如 **param ， 那 么 人 那 一 点 开始 到 
被 收集 到 一 个 叫 param 的 字典 中 。 


结束 的 所 有 关键 字 参 数 都 


我 们 将 在 数据 结构 中 探讨 元 组 和 字典 。 


returnié 4 


return 语句 用 来 从 函数 中 return( 返 回 )， 也 就 是 说 跳出 函数 。 同 样 ， 我 们 也 可 以 从 函数 中 选择 
性 地 返回 一 个 值 。 


例子 (保存 为 func_return.py): 


def maximum(x, y): 


if x > y: 

return x 
elif x == y: 

return ' 两 个 数 相 等 ' 
else: 

return y 


print(maximum(2, 3)) 


输出 : 


$ python func_return.py 
3 


它 是 如 何 工 作 的 : 


函数 maximum 返回 参数 中 的 最 大 值 ， 在 这 个 例子 中 是 提供 给 函数 的 数值 。 它 使 用 了 简单 
的 if. .else 语句 找到 比较 大 的 值 ， 然 后 返回 那个 值 。 


注意 ， 没 有 一 个 值 的 return 语句 相当 于 return none (什么 也 不 返回 )。 None 是 Python 中 的 一 
个 特殊 类 型 ， 它 代表 什么 也 没有 。 例 如 ， 如 果 一 个 变量 的 值 是 None ， 它 说 明 这 个 变量 没有 
值 。 


除非 你 已 经 写 了 自己 的 return 语句 ， 否 则 ， 每 个 函数 都 默认 包含 一 个 return None 18 4 ° 7 
过 运行 print(someFunction()) 你 可 以 看 到 这 一 点 ， 这 里 someFunction 没有 使 用 return 语 
aJ > Hoke : 


def someFunction(): 
pass 


在 Python 中 pass 语 句 用 来 说 明 一 个 空 的 语句 块 。 


提示 : 已 经 有 一 个 


MH max 的 内 建 函 数 能 够 完成 'find maximum' 函 数 的 功能 ， 因 此 ， 只 要 
可 能 使 用 这 个 内 建 耳 3 


He o 
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Python 有 一 个 叫 文档 字符 串 的 好 特性 ， 通 常用 缩写 名 aqocstnngs 来 指定 。 文档 字符 串 是 你 应 
人 一 人 和 工人 令 其 容易 理解 。 令 人 惊讶 的 是 ， 当 程序 实际 运 
行 时 ， 我 们 甚至 可 以 从 例如 一 个 函数 返 档 字 符 囊 。 


例子 (保存 为 func_doc.py): 


def printMax(x, y): 
' "打印 两 个 数 中 的 最 大 值 。 


两 个 值 必 须 是 整数 。 

E 如 果 可 能 ， 转 换 为 整数 
x = int(x) 

int(y) 


aki 3 22 WH 

print(x, '%X') 
else: 

print(y, 'xX') 


printMax(3, 5) 
print(printMax._doc__) 


输出 : 


$ python func_doc.py 
5 最 大 
打印 两 个 数 中 的 最 大 值 。 


两 个 值 必 须 是 整数 。 


它 是 如 何 工 作 的 : 


函数 的 第 一 个 逻辑 行 的 字符 串 是 那个 函数 的 文档 字符 串 。 注 意 ， 文 档 字符 串 也 适用 于 在 后 面 
的 章节 将 要 学 习 的 模块 和 类 。 


文档 的 贯 例 是 多 行 字 符 串 ， 第 一 行 以 大 写字 母 开 头 以 句点 (.) 结 束 ( 注 : 可 以 使 用 中 文 )， 第 二 行 
是 空 行 ， 从 第 三 行 开始 是 详细 描述 。 强 烈 建 议 ， 为 你 重要 的 函数 写 文档 字符 串 要 遵循 此 贯 
例 o 


我 们 可 以 使 用 printMax HAKI _doc_ (ZB? TRAJA (A TE Fi) Ml printMax 4 a 
的 文档 字符 串 。 只 要 记 住 ，Python 把 一 切 事物 作为 一 个 对 象 对 待 ， 这 也 包括 函数 。 我 们 将 在 
类 这 一 章 学 习 关 于 对 象 的 更 多 知识 。 


如 果 你 在 Python 中 已 经 使 用 过 help() ， 那 么 你 已 经 看 到 如 何 使 用 文档 字符 串 了 ! 它 所 做 的 仅 
仅 是 获取 函数 的 _ doc 属性 ， 并 以 一 个 整洁 的 方式 显示 给 你 。 你 可 以 在 上 面 的 函数 一 一 在 
你 的 程序 中 仅 包括 help(printMax ) 尝试 一 下 。 记得 按 下 q 键 ， 退 出 help ° 


自动 化 工具 可 以 从 你 的 程序 中 以 这 种 方式 检索 文档 。 因 此 ， 我 强烈 建议 ， 为 你 写 的 任何 重要 
SRS A HFA Bo KA Python 的 自动 化 工具 pydoc 命令 使 用 文档 字符 串 的 工作 原理 类 似 
于 help() ° 


RN CAME BRORS AO FER? RINMRAAFBASZECNHAAA Oc Ri? KN 
LAR & T Python Bk A #4 FAY KBD ° 


接 下 来 ， 我 们 将 看 到 如 何 创建 及 使 用 Python 模块 。 


继续 阅读 模块 


模块 


您 已 经 看 到 如 何 通过 一 次 定义 函数 在 程序 中 重用 代码 。 如 果 你 想 在 其 它 程序 中 重用 一 定数 量 
的 函数 ， 你 将 写 什 么 ? 正如 你 可 能 已 经 猜 到 了 ， 答 案 是 模块 。 


编写 模块 有 各 种 各 样 的 方法 ， 但 是 最 简单 的 方法 是 创建 一 个 以 .py 为 扩展 名 、 包 含 函 数 和 变量 
的 文件 。 


编写 模块 的 另 一 种 方式 是 使 用 编写 Python 解释 器 本 身 的 本 机 语言 ， 例 如 ， 你 可 以 使 用 C 编程 
语言 编写 模块 ， 当 它们 被 编译 后 ， 当 使 用 标准 的 Python 解释 器 时 ， 在 你 Python 代码 中 可 以 使 
用 这 些 模块 。 


一 个 模块 可 以 因 另 一 个 程序 使 用 其 功能 而 被 imported( 导 入 )。 同 样 ， 我 们 可 以 使 用 Python 标 准 
库 。 首 先 ,我 们 将 看 到 如 何 使 用 标准 库 模块 。 


例子 (保存 为 using_sys.py): 


import sys 


print(' 命 令 行 参数 是 : ' ) 
for i in sys.argv: 
print(i) 


print('\n\nPYTHONPATH#', sys.path, '\n') 


输出 : 


$ python using_sys.py we are arguments 
命令 行 参数 是 

using_sys.py 

we 

are 

arguments 


PYTHONPATHZ ['/tmp/py', 

# 还 有 很 多 ， 这 里 不 一 一 列 出 
'/Library/Python/2.7/site-packages', 
"/usr/local/lib/python2.7/site-packages' ] 


它 是 如 何 工作 的 : 


首先 ,我 们 使 用 import 语句 jmport 导 入 sys (系统 ) 模块 。 基 本 上 ， 这 意味 着 我 们 我 们 想 告 诉 
Python， 我 们 想 使 用 这 个 模块 。 sys 模块 包含 了 与 Python 解释 器 和 其 环境 即 system 系 统 有 关 
的 函数 。 


当 Python 执 行 import sys 语句 时 ， 它 查找 sys 模块 。 在 这 里 ， 它 是 一 个 内 建 模 块 ， 因 此 ， 
Python 知道 到 去 哪里 找到 它 。 


如 果 它 不 是 一 个 编译 的 也 就 是 用 Python 写 的 模块 » ABZ » Python 解释 器 将 在 sys.path 变量 
列表 中 的 目录 中 搜索 。 如 果 模 块 被 发 现 ， 那 么 ， 模 块 中 的 代码 将 运行 ， 对 你 来 说 ， 使 用 模块 
变 为 有 效 。 注 意 ， 初 始 化 只 有 在 我 们 第 一 次 导入 一 个 模块 时 完成 。 


在 sys 模块 中 的 argv 变量 是 通过 点 符号 访问 的 ， 例 如 ， 例 如 ， syS.argv ° 它 清楚 地 表明 > 
这 个 名 字 是 sys 模块 的 一 部 分 。 这 种 方法 的 另 一 个 优点 是 ， 这 个 名 字 与 你 的 程序 中 使 用 的 任 
何 argv 变量 都 不 冲突 。 


sys.argv 变量 一 个 字符 串 /ist( 列 表 )。 具 体 来 说 ， sys.argv 包含 命令 行 参数 ， 也 就 是 使 用 命令 
行 向 你 的 程序 传递 参数 的 列表 。 


如 果 您 正在 使 用 IDE 编 写 并 运行 这 些 程序 ， 在 菜单 中 寻找 一 种 方法 来 指定 命令 行 参数 传递 给 你 
的 程序 。 


这 里 ， 当 我 们 执行 python using_sys.py we are arguments 时 ， 我 们 使 用 python 命令 和 其 后 
的 传递 给 程序 的 参数 运行 using_sys.py 模块 。Python 把 命令 行 参 数 存 储 在 sys.argv 变量 中 供 
我 们 使 用 。 


记 住 ， 运 行 脚本 的 名 字 通 常 是 sys.argv 列表 中 的 第 一 个 参数 。 因 此 ， 在 这 里 将 
有 "using_sys.py' 作为 sys.argv[O] ， 'we' 作为 sys.argv[1] ’ 'are' VE 
为 sys.argv[2] 和 'arguments' 作为 sys.argv[3] 。 注 意 ，Python 从 0 而 不 是 1 开始 数 数 。 


sys.path 包含 被 导入 的 模块 所 在 的 目录 名 列表 。 我 们 发 现 sys.path 的 第 一 个 字符 串 是 空 的 
这 个 空 字 符 串 表示 当前 目录 是 和 PYTHONPATH 环 境 变量 相同 的 ， 同 时 也 是 sys.path 变 
量 的 一 部 分 。 这 意味 着 你 可 以 直接 导入 位 于 当前 目录 中 的 模块 。 否 则 ， 你 将 不 得 不 把 你 的 模 
块 存放 在 sys.path 列表 中 的 一 个 目录 中 。 





请 注意 ,当前 目 录 是 程序 局 动 的 目录 。 运 行 import os; print(os.getcwd()) 找到 你 的 程序 的 
当前 目录 。 


字 节 编译 的 .pyc 文 件 


导入 一 个 模块 是 一 个 相对 昂贵 的 事情 ， 所 以 Python 做 了 一 些 技巧 使 它 更 快 。 一 种 方法 是 创建 
扩展 名 为 .pyc 的 字 节 编译 文件 ， 是 Python 将 程序 转换 成 的 一 种 中 间 形 式 。( 记 得 在 Python 如 
何 工作 的 简介 。 当 你 下 次 从 一 个 不 同 程序 导入 模块 时 ， 这 种 .pyc 文件 是 有 很 用 的 -- 它 将 快 得 
多 ， 因 为 导入 模块 一 部 分 需要 的 处 理 已 经 完成 。 同 时 ， 这 些 字 节 编译 的 文件 是 独立 于 平台 
的 o 


注意 : 这 些 ,pyc 文件 通常 在 与 之 相应 的 .py 文件 的 同一 个 目录 中 创建 。 如 果 Python 在 那个 


些 
目录 中 没有 号 入 权限 ， 那 么 pyc 文件 将 不 会 创建 。 


from ... importié 4 


如 果 你 想 直 接 导 入 argv 变量 到 程序 中 (为 了 避免 每 次 为 它 键 入 sys. )， 那 么 您 可 以 使 用 from 


sys import argv TB a] © 


一 般 来 说 ， 你 应 该 避免 使 用 这 个 语句 ， 而 应 该 使 用 import 语句 ， 因 为 你 的 程序 将 避免 名 
称 冲 突 ， 将 更 具 可 读 性 。 


例如 : 


from math import sqrt 
print("16% FRÆ", sqrt(16)) 


模块 的 ”name 


每 个 模块 都 有 一 个 名 字 ， 在 模块 中 的 语句 能 够 找 出 它 所 在 的 模块 的 名 字 。 这 对 于 搞 清楚 模块 
是 否 正在 运行 或 被 导入 这 样 的 特殊 用 途 是 很 方便 的 。 正 如 前 面 提 到 的 ， 当 一 个 模块 被 第 一 次 
导入 时 ， 其 所 包含 的 代码 被 执行 。 我 们 可 以 通过 使 用 这 个 ， 根 据 模块 是 否 被 自己 使 用 或 从 另 
一 个 模块 被 导入 ， 使 模块 以 不 同 的 方式 起 作用 ， 这 些 可 以 通过 使 用 模块 的 _name 属性 来 实 
现 。 


例子 (保存 为 using_name.py): 


ash name == '_main_': 
print(' 这 个 程序 正在 被 自己 运行 ' ) 
else: 
print(' 我 从 别 的 模块 被 导入 ') 





输出 : 


$ python using_name.py 
这 个 程序 正在 被 自己 运行 

$ python3 

>>> import using_name 
我 从 别 的 模块 被 导入 


>>> 


它 是 如 何 工 作 的 : 


每 个 Python 模块 有 其 _name 定义 ， 如 果 是 ，_name_，， 这 意味 着 模块 在 被 用 户 独立 的 运 
行 ， 我 们 可 以 采取 适当 的 行动 。 


ak 
制作 属于 你 自己 的 模块 
创建 自己 的 模块 是 很 容易 的 ， 你 一 直 在 这 样 做 ， 始 终 都 是 ! 这 是 因为 每 个 Python 程序 也 是 一 
个 模块 。 你 只 需要 确保 它 有 一 个 .py 扩展 名 。 下 面 的 例子 会 让 你 明白 。 


例子 (保存 为 nymodule.py): 


def sayhi(): 
print ('%# > RCRYRREHTIE © ' ) 


__version__ = '0.1' 


上 面 的 是 模块 的 一 个 示例 。 正 如 您 可 以 看 到 的 ， 和 我 们 通过 的 Python 程序 相 比 ， 没 有 什么 特 
别 的 。 接 下 来 我 们 要 看 如 何在 我 们 的 其 它 程 序 中 使 用 这 个 模块 。 


记 住 ,该 模块 要 么 放置 在 我 们 导入 它 的 程序 相同 的 目录 中 ， 要 人 么 放置 在 sys.path 目录 列表 中 的 
一 个 目录 中 。 


另 一 个 模块 (保存 为 mymodule demo.py): 


import mymodule 


mymodule.sayhi( ) 
print(' 版 本 ',，mymodule. version ) 


输出 : 


$ python mymodule demo.py 
嗨 ， 这 是 我 的 模块 在 讲话 。 
版 本 0.1 


它 是 如 何 工 作 的 : 


注意 ， 我 们 使 用 相同 的 点 符号 来 访问 模块 的 成 员 。Python 充 分 重用 相同 的 符号 产生 了 独特 
的 'Pythonic' 的 感觉 ， 这 样 我 们 不 需要 不 断 学 习 新 的 方法 来 做 事情 。 


这 是 使 用 from..import 语法 的 一 个 版 本 (保存 为 mymodule_demo2.py): 


from mymodule import sayhi, __version__ 


sayhi() 
print('ikA', __version_) 


mymodule_demo2. py 和 mymodule_demo. py 的 输出 相同 。 


注意 ， 如 果 在 导入 模块 中 已 经 有 一 个 version 名 字 的 声明 ， 这 里 会 有 一 个 冲突 。 这 也 可 能 是 因 
为 它 是 常见 的 做 法 -- 对 于 每 个 模块 使 用 这 个 名 字 声 明 它 的 版 本 号 。 因 此 ， 总 是 
择 import 语句 ， 虽 然 它 可 能 让 你 的 程序 有 点 长 。 


你 还 可 以 使 用 : 


from mymodule import * 


这 将 导入 所 有 的 公共 名 称 如 Sayhi， 但 不 会 导入 version， 因 为 它 始 于 双 下 划 线 。 
注意 : 尽量 不 要 使 用 import * 这 种 方式 ， 诸 如 from mymodule import * 等 


Python 的 禅 Python 的 一 个 指导 原则 是 " 显 式 优 于 隐 式 "。 和 运行 import this 去 学 习 更 多 相关 


的 信息 。 


dir 有 函数 
您 可 以 使 用 内 置 的 dir 函数 列 出 一 个 定义 对 象 的 标识 符 。 例 如 ,对 于 一 个 模块 ， 包 括 在 模块 中 
定义 的 函数 ， 类 和 变量 。 


当 你 给 dir() 提 供 一 个 模块 名 字 时 ， 它 返回 在 那个 模块 中 定义 的 名 字 的 列表 。 当 没有 为 其 提供 参 
数 时 , 它 返回 当前 模块 中 定义 的 名 字 的 列表 。 


例如 : 


$ python 
>>> import sys 
# 获得 属性 列表 ， 在 这 里 是 sys 模 块 的 属性 列表 


>>> dir(sys) 
['__displayhook__', '_doc ', ' excepthook ', '_name ', '_ package ', '_ s 








tderr__', '_ stdin ', '_ stdout ', '_clear_type_cache', '_compact_freelists', 





'_current_frames', '_getframe', ‘api_version', 'argv', 'builtin_module_names', ' 
byteorder', 'call tracing', 'callstats', 'copyright', 'displayhook', 'dllhandle' 
, ‘dont_write_bytecode', 'exc_info', 'excepthook', 'exec_prefix', 'executable', 
'exit', 'flags', 'float_info', 'getcheckinterval', 'getdefaultencoding', 'getfil 
esystemencoding', 'getprofile', 'getrecursionlimit', 'getrefcount', 'getsizeof', 
"gettrace', 'getwindowsversion', 'hexversion', 'intern', 'maxsize', 'maxunicode 
', 'meta_path', 'modules', 'path', 'path_hooks', 'path_importer_cache', 'platfor 
m', 'prefix', 'psi', 'ps2', 'setcheckinterval', 'setprofile', 'setrecursionlimit 
', 'settrace', 'stderr', 'stdin', 'stdout', 'subversion', 'version', 'version_in 
fo', 'warnoptions', ‘'winver'] 


# 获得 当前 模块 的 属性 列表 
>>> dir() 


['__builtins__', '_doc__', '__name__', '__package__', 'sys'] 





# 创建 了 一 个 新 变量 'a' 
>>> a = 5 


>>> dir() 


['__builtins__', '_doc__', '__name__', '__package__', OO ‘'sys'] 





# 删除 / 移 除 一 个 名 字 
>>> del a 


>>> dir() 


['__builtins__", '_doc__', '__name__', '__package__', ‘sys"] 





>>> 


它 是 如 何 工 作 的 : 
首先 ， 我 们 看 到 在 导入 sys 模块 上 使 用 使 用 dir 。 我 们 能 看 到 模块 包含 的 巨大 的 属性 列表 。 


， 我 们 使 用 没有 传递 参数 的 dir 


函数 。 上 默认 情况 下 ， 它 返回 模块 的 属性 的 列表 。 注 意 ， 
导入 模块 的 列表 仍然 是 这 个 列表 的 一 部 分 。 


为 了 看 到 dir 在 起 作用 ， 我 们 定义 了 一 个 新 的 变量 ， 并 为 其 赋值 ， 然 后 检查 dir ， 我 们 发 现 
列表 中 添加 了 一 个 同名 变量 。 我 们 使 用 del 语句 移 除 当前 模块 的 变量 或 属性 ， 在 del 函数 的 
输出 中 变化 再 次 得 到 体现 。 


eea E 个 语句 用 于 删除 一 个 变量 /属性 ， 语 名 运行 后 ， 这 里 是 dela? 
能 再 访问 变量 a -- 就 像 它 从 来 根本 没有 存在 过 。 


注意 ，dir() 函数 对 任何 对 象 都 起 作用 。 例 如 ， 运 行 dir('str') 来 学 习 str (string) 类 型 的 更 


多 知识 。 


打包 (Packages) 
ME 9 RLR A LR RAR AGREE AG KR RSME RAAB o haa REA 
常 在 模块 内 部 。 如 果 你 想 组 织 模块 ? 这 就 到 了 牵涉 到 打包 的 地 方 了 。 


包 只 是 模块 的 文件 夹 ， 使 用 一 个 特殊 的 _ init .py 文件 ， 指 示 Python， 这 个 文件 夹 是 特殊 
的 ， 因 为 它 包 含 Python 模 块 。 


假设 你 想 创建 一 个 叫做 ' 世 界 ' 的 程序 包 ， 分 灼 ' 亚 洲 、' 非 洲 ' 等 等 ， 分 包 按 序 包含 ' 印 度 '、' 马 达 加 


KE KE 


斯 加 ' 等 等 。 


这 是 你 的 文件 结构 : 


- < 在 Sys .path 中 现 有 的 一 些 文件 夹 >/ 
- world/ 
- __init__.py 
- asia/ 
- __init__.py 
- india/ 
- __init__.py 
- foo.py 
- africa/ 
- __init__.py 
- madagascar/ 
- __init__.py 
- bar.py 


包 只 是 为 了 分 层次 组 织 模块 的 方便 。 在 标准 库 中 ， 你 会 看 到 包 的 许多 实例 。 


就 像 函 数 是 可 重用 的 部 分 的 程序 一 样 ， 模 块 也 是 可 重用 的 程序 。 包 是 组 织 模块 的 另 一 个 层次 
结构 。 来 自 Python 的 标准 库 ， 是 包 和 模块 的 集合 中 的 一 个 例子 。 


我 们 已 经 看 到 了 如 何 使 用 这 些 模块 和 创建 我 们 自己 的 模块 。 
接 下 来 ， 我 们 将 学 习 一 些 有 趣 的 称 为 数据 结构 的 概念 。 


继续 阅读 数据 结构 


模块 
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数据 结构 


数据 结构 用 来 将 一 些 数据 组 织 在 一 起 。 换 名 话说 ， 它 们 是 用 来 存储 一 系列 相关 的 数据 。 


在 Python 中 有 四 种 内 建 数据 结构 -- 列 表 、 元 组 、 字 典 和 集合 ， 我 们 将 看 到 如 何 使 用 它们 中 的 每 
一 个 ， 它 们 是 怎样 使 我 们 的 生活 更 容易 的 。 


列表 


列表 是 一 种 数据 结构 > 它 保 存 条 目 的 有 序 集 合 o 例如 你 可 以 在 列表 中 存储 一 个 序列 > 这 很 
容易 想象 ， 你 想像 一 下 购物 清单 ,那里 有 你 要 购买 物品 的 一 个 清单 o 除非 在 你 的 清单 上 每 一 行 
列 有 一 个 单独 物品 ， 然 而 ， 在 python 中 ， 你 在 它们 中 间 放 上 运 号 。 


条 目的 列表 应 包含 在 方 括 号 内 ， 以 便 Python 明 白 你 在 指定 一 个 列表 。 一 旦 您 创建 了 一 个 列 
表 ， 你 可 以 添加 、 删 除 或 是 搜索 列表 中 的 条 目 。 因 为 我 们 可 以 添加 和 删除 条 目 ， 我 们 说 一 个 
列表 是 一 个 可 变 的 数据 类 型 ， 即 这 种 类 型 可 以 更 改 。 


对 象 和 类 的 快速 介绍 


尽管 直到 现在 ， 我 一 直 推 迟 讨 论 对 象 和 类 ， 现 在 需要 一 个 小 小 的 解释 ， 这 样 你 可 以 更 好 的 理 
解 列 表 。 我 们 将 在 后 面 齐 节 中 详细 探讨 这 一 课题 。 


列表 是 使 用 对 象 和 类 的 一 个 例子 。 当 我 们 使 用 一 个 变量 1， 为 它 分 配 一 个 值 ， 例 如 把 整数 5 赋 
值 给 它 ， 你 可 以 认为 它 是 创建 一 个 类 为 int〈 即 类 型 ) 的 对 象 ( 即 实例 )i。 事 实 上 ， 你 可 以 阅 
读 help(int) 更 好 地 理解 这 一 点 。 


类 也 有 方法 ， 也 就 是 为 了 使 用 而 定义 的 只 关于 那个 类 的 函数 ， 只 有 当 你 有 那个 类 的 对 象 时 ， 
你 才 可 以 使 用 这 些 函 数 .例如 ，Python 为 list (列表 ) 类 提供 了 一 个 append 方法 ， 它 允许 你 
在 列表 的 整改 添加 一 个 条 目 。 例 如 ， mylist.append('an item') 将 给 列表 mylist 添加 字符 

串 。 注 意 ， 我 们 使 用 点 操作 符 访问 对 象 的 方法 。 


类 也 有 字段 ， 除 了 为 了 使 用 而 定义 的 只 与 那个 类 相关 的 变量 ， 它 什么 也 没有 。 只 有 当 你 有 那 
个 类 的 对 象 时 ， 你 可 以 使 用 那些 变量 或 名 字 。 字 段 孔明 通过 点 操作 符 访问 的 。 例 
如 ， mylist.field 。 


例子 (保存 为 using_list.py): 


Ih AE AE ET 
H 37 2 st ph hast we 
FH 1 {AE IAA 1H 


shoplist = ['#R', 'ER', 'A¥h', TAa] 
print(' 我 要 买 '，len(shoplist)，' 个 物品 。') 


print('m*%2:', end=' ') 
for item in shoplist: 
print(item, end=' ') 


print('Nn 我 还 要 买 大 米 。' ) 
shoplist.append('**') 
print(' 现 在 我 的 清单 是 '， shoplist) 


print(' 现 在 我 将 要 为 我 的 清单 排序 ') 
shoplist.sort() 
print(' 排 序 后 的 购物 清单 是 '， shoplist) 


print(' 我 要 买 的 第 一 个 物品 是 '， shoplist[0]) 
olditem = shoplist[0] 

del shoplist[0] 

print(' 我 已 经 买 了 '，olditem) 
print(' 现 在 我 的 清单 是 '， shoplist) 


输出 : 


$ python using_list.py 

REE 4 个 物品 。 

清单 是 : 苹果 芒果 胡萝卜 香蕉 

DERN Gee [ER', 'ER', (AFL, (FR, KAY 
现在 我 将 要 为 我 的 清单 排序 

排序 后 的 购物 清单 是 KX, AF h, 'ER', '#R', 'FA'] 
我 要 买 的 第 一 个 物品 是 大 米 

我 已 经 买 了 大 米 

现在 我 的 清单 是 [MF b', 'ER', 'FR', 'FR'] 


它 是 如 何 工作 的 : 


变量 shoplist 是 将 要 去 超市 的 人 的 一 个 购物 清单 。 在 shoplist 中 ， 我 们 只 存储 了 要 买 的 物 
品 的 名 字 的 字符 囊 ， 你 可 以 向 清单 中 添加 包括 数字 甚至 是 其 它 清单 的 任何 对 象 。 


我 们 也 使 用 了 循环 for..in 遍历 清单 中 的 所 有 条 目 。 到 现在 为 止 ， 你 必须 认识 到 一 个 列表 也 
是 一 个 序列 。 序 列 的 特性 将 在 后 面 的 章节 中 讨论 。 


注意 ， 在 print 函数 中 使 用 end 关键 字 参 数 ， 表 明 输 出 以 一 个 空格 结束 而 不 是 通常 的 换行 。 


接 下 来 ， 和 前 面 讨 论 过 的 一 样 ， 我 们 使 用 列表 对 象 的 append 方法 向 列表 中 添加 一 个 项 目 。 然 
后 ， 我 们 只 把 列表 简单 地 传递 给 print 语句 ， 整 洁 地 打印 列表 的 内 容 ， 以 检查 这 个 条 目 确实 
添加 到 了 列表 中 。 


然后 ， 我 们 使 用 列表 对 象 的 sort 方法 为 列表 排序 。 这 个 方法 作用 到 列表 本 身 ， 并 不 返回 一 
个 修改 过 的 列表 ， 理 解 这 一 点 很 很 重要 ， 它 不 同 于 对 字符 串 的 操作 。 这 也 是 为 什么 我 们 列表 
是 可 修改 的 ， 而 字符 串 是 不 可 修改 的 原因 。 


然后 ， 我 们 在 超市 购买 了 一 个 物品 ， 我 们 想 把 它 从 购物 清单 中 移 除 ， 通 过 使 用 del 语句 来 实 
现 。 这 里 ， 我 们 提 到 我 们 想 要 移 除 清单 中 的 哪个 物品 ，del 语 名 为 我 们 将 它 从 清单 中 移 除 。 我 
们 指定 ， 我 们 想 从 清单 移 除 第 一 项 ， 因 此 ， 我 们 使 用 del shoplist[o] ( 记 住 ，Python 从 0 开始 
计数 ) 。 


如 果 你 想 知 道 列 表 对 象 定义 的 所 有 方法 ， 详 见 help(list) ° 


元 组 

元 组 是 用 来 容纳 多 个 对 象 。 认 为 它们 是 类 似 于 列表 ， 但 是 没有 列表 给 你 的 广泛 功能 。 元 组 的 
一 个 主要 特征 是 他 们 是 不 可 变 ， 像 字符 事 ， 即 您 不 能 修改 元 组 。 

元 组 是 通过 在 一 对 可 选 的 圆 括号 中 ， 项 目 之 间 用 运 号 分 隔 来 定义 的 。 


元 组 通常 用 在 ， 一 个 语句 或 一 个 用 户 定义 的 函数 能 够 安全 地 假设 为 值 的 集合 ， 即 值 的 元 组 ， 


不 会 改变 。 


例子 (保存 为 using_tuple.py): 











# +3 ik 式 P 了 Heys KP 明 更 加 直 W 
zoo = ('H3E', 'AR', EW) # 记 住 国 桥 号 是 可 选 的 


print(' 动 物 园 中 动物 有 数量 有 '，1len(z00)) 


new_zoo = ' 猴 子 '，' 骆 驼 '，Z00 

print(' 在 新 动物 园 中 笼子 的 数量 是 '，Jlen(new_zoo) ) 

print(' 在 新 动物 园 所 有 的 动物 是 '，new_z00) 
print(' 从 老 动物 园 中 带 来 的 动物 是 '，new_zoo[2]) 

print(' 从 老 动物 园 带 来 最 后 的 动物 是 '，new_zoo[2][2]) 

print(' 在 新 动物 园 中 动物 的 数量 有 '，1len(new_z00)-1it+len(new_zo0[2])) 


输出 : 


$ python using_tuple.py 

动物 园 中 动物 有 数量 有 3 

在 新 动物 园 中 笼子 的 数量 是 3 

在 新 动物 园 所 有 的 动物 是 ( ' 猴 子 !， |, (RE, 'AR', '449')) 
从 老 动物 园 中 带 来 的 动物 是 (RE, ' 大 象 !， 1e) 

从 老 动物 园 带 来 最 后 的 动物 是 NE 

在 新 动物 园 中 动物 的 数量 有 5 


它 是 如 何 工 作 的 : 


变量 zoo 指 的 是 一 个 物品 的 元 组 。 我 们 看 到 len 子 数 可 以 用 来 获取 元 组 的 长 度 。 这 也 表明 ， 
一 个 元 组 同样 也 是 一 个 序列 。 


因为 老 动物 园 z00 将 要 关闭 ， 我 们 现在 将 这 些 动物 迁移 到 一 个 新 的 动物 园 new zoo 。 因 此 ， 
(新 动物 园 ) new_z00 的 tuple 包 含 一 些 已 经 存在 的 动物 以 及 从 老 动物 园 zo0 带 来 的 动物 。 回 到 
现实 ， 请 注意 ， 在 一 个 元 组 中 的 元 组 不 失去 其 特性 。 


就 像 列 表 一 样 ， 我 们 可 以 通过 在 一 对 方 括号 中 指定 条 目的 位 置 ， 访 问 元 组 中 的 物品 。 这 被 称 
为 索引 操作 符 。 我 们 通过 指定 new _zoo[2] 访问 新 动物 园 new_zoo 中 的 第 三 项 ， 通 过 指 
Æ new_zoo[2][2] 访问 新 动物 园 new_zoo 的 第 三 项 。 一 旦 理解 这 个 习 语 ， 这 是 非常 简单 的 。 


有 0 个 或 1 个 条 目的 元 组 

一 个 空 的 元 组 由 一 对 空 的 括号 如 myempty = OQ 组 成 。 然而 ， 只 有 一 个 对 象 的 元 组 并 非 如 
此 简单 。 你 必须 通过 在 第 一 个 对 象 〈 唯 一 的 一 个 ) 后 紧 跟 一 个 过 号 来 指定 它 ， 这 样 
Python 可 以 区 分 是 一 个 元 组 还 是 一 个 表达 式 中 一 个 对 象 的 括号 ， 例 如 ， 如 果 你 想 定义 一 
个 只 含 一 个 对 象 这 为 2 的 元 组 ， 你 必须 使 用 singleton = (2, ) ° 

Perl 程 序 员 应 该 注意 

在 一 个 列表 中 的 列表 不 会 失去 其 特性 ， 也 就 是 说 并 不 像 在 Perl 中 夷 为 平地 。 这 同样 适用 于 
在 一 个 元 组 中 的 一 个 元 组 ， 或 在 一 个 列表 中 的 元 组 ， 或 在 一 个 元 组 中 的 列表 等 。 就 
Python 而 言 ， 他 们 只 是 存储 在 另 一 个 对 象 中 的 一 个 对 象 
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IN 
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字典 就 像 一 个 地 址 簿 ， 在 那里 你 只 通过 知道 他 /她 的 名 字 ， 就 可 以 找到 地 址 或 联系 人 详细 信 
息 。 也 就 是 说 ， 我 们 使 用 键 (姓名 ) 与 值 (细节 ) 相 联系 。 注 意 ， 键 必须 是 独一无二 的 ， 就 像 如 果 
有 两 个 完全 相同 的 名 字 的 人 ， 你 无 法 找到 正确 的 信息 。 


注意 ， 字 典 的 关键 字 你 只 能 使 用 不 可 变 的 对 象 (比如 字符 串 )， 你 可 以 使 用 不 可 变 或 可 变 的 对 象 
作为 字典 的 值 。 这 基本 上 意味 着 ， 简 单 地 说 ， 对 于 键 你 只 能 使 用 简单 对 象 。 


在 字典 ean 值 是 通过 使 用 冒号 指定 的 ， 如 ， g = {keyi : valuei, key2 : value2 } ° 
注意 ， 键 值 对 用 冒号 分 隔 ， 彼 此 之 间 以 去 号 分 隔 ， 所 有 这 些 都 是 包含 在 一 对 大 括号 中 。 


记 住 ， 在 字典 中 键 - 值 对 不 以 任何 方式 排序 。 如 果 你 想 要 一 个 特定 的 顺序 ， 那 么 你 将 不 得 不 在 
使 用 前 自己 排序 。 


你 将 要 使 用 的 字典 是 dict 类 的 对 象 或 实例 。 


例子 (保存 为 using_dict.py): 


# "ab' 是 英文 address book( 地 址 簿 ) 的 首 个 字母 


ab ={ 'Swaroop' : 'swaroop@swaroopch.com', 
"Larry' : 'larry@wall.org', 
"Matsumoto' : 'matz@ruby-lang.org', 
"Spammer ' : 'spammer@hotmail.com' 
} 


print("Swaroop 的 地 址 是 "，ab['Swaroop']) 


# 删除 一 个 键 - 值 对 
del ab['Spammer '] 


print('\n 地 址 薄 中 有 {0} + AA\n'. format (len(ab))) 


for name, address in ab.items(): 
print(' 联 系 人 {0} 的 地 址 是 {1}'.format(name, address) ) 


# 添加 一 个 键 - 值 对 
ab['Guido'] = 'guido@python.org' 


if 'Guido' in ab: 


print("\nGuidots usb", ab['Guido']) 


输出 : 


$ python using_dict.py 
Swaroop 4) usb swaroop@swaroopch.com 


地 址 薄 中 有 3 个 联系 人 
联系 人 Larry 的 地 址 是 larry@wall.org 
联系 人 Matsumoto 的 地 址 是 matz@ruby-lang.org 


联系 人 Swaroop 的 地 址 是 swaroop@swaroopch.com 


Guido 的 地 址 是 guido@python.org 


它 是 如 何 工 作 的 : 
我 们 使 用 已 经 讨论 过 的 符号 创建 字典 ab 。 然 后 我 们 通过 使 用 在 列表 和 元 组 中 讨论 过 的 索引 操 
作 符 一 一 指定 关键 字 来 访问 键 - 值 对 ， 遵 守 简 单 的 语法 。 


我 们 可 以 使 用 我 们 的 老 朋 友 一 一 del 语句 删除 键 值 对 ， 我 们 简单 地 指定 字典 和 要 删除 的 关键 
字 的 索引 操作 符 ， 并 将 它 传递 给 del 语句 。 对 于 这 个 操作 ， 没 有 必要 知道 对 应 于 关键 字 的 
值 。 


接 下 来 ， 我 们 我 们 使 用 字典 的 items 方法 ， 访 问 字典 的 每 个 键 - 值 对 的 。 它 返回 一 个 元 组 的 列 
表 ， 每 个 元 组 包含 一 对 值 -- 关 键 字 及 紧 随 其 后 的 值 。 我 们 检索 这 对 值 并 使 用 for..in 循 环 为 每 一 
对 分 配给 相应 的 变量 name 和 address ， 然 后 在 for..in 块 中 打印 这 些 值 。 


我 们 可 以 通过 简单 地 使 用 索引 操作 符 来 访问 一 个 键 并 分 配 值 的 方式 添加 新 的 键 值 对 ， 像 上 面 
的 例子 中 我 们 所 做 的 添加 Guido。 


我 们 可 以 使 用 in 操作 符 来 检查 一 个 键 值 对 是 否 存 在 。 


字典 dict 类 的 列表 方法 ， 请 看 help(dict) 。 


KARE RA fo FR 
如 果 你 已 经 在 函数 中 使 用 过 了 关键 字 参 数 ， 那 么 你 已 经 接触 过 。 想 象 一 下 ， 这 个 
键 值 对 是 在 函数 定义 的 参数 列表 中 指 A E ear 


的 一 个 键 (在 编译 器 设计 术语 中 称 为 符号 表 ) 。 


序列 


列表 、 元 组 和 字符 串 都 序列 的 一 个 实例 ， 但 是 什么 是 序列 ， 它 们 为 什么 如 此 特殊 呢 ? 


主要 特点 是 成 员 测试 ， 即 in( 在 ) 和 not in( 不 在 ) 表 达 式 中 和 索引 操作 ， 这 使 我 们 在 一 个 序列 中 能 
够 直接 获取 一 个 特定 的 对 象 。 


上 面 提 到 的 一 一 列表 、 元 组 和 字符 串 这 三 种 类 型 的 序列 ， 也 有 人 允许 我 们 找 回 一 彼 序列 即 序列 
的 一 部 分 的 切片 操作 。 


例子 (保存 为 seq.py): 


shoplist = ['¥#%', '2R', 'A¥h', 'FR'] 
name = 'swaroop' 


# Indexing or 'Subscription' operation 
print(' 第 0 项 是 '， shoplist[0]) 
print(' 第 1 项 是 '， shoplist[1]) 
print(' 第 2 项 是 '， shoplist[2]) 
print(' 第 3 项 是 '，shoplist[3]) 
print(' 第 -1 项 是 '，shoplist[-1]) 
print(' 第 -2 项 是 '，shoplist[-2]) 


re 


print(' 第 9 个 字符 是 '，name[0]) 

# 一 个 列表 的 切片 

print(' 第 1 项 到 第 3 项 是 '，shoplist[1:3]) 
print(' 第 2 项 到 末尾 是 '， shoplist[2:]) 


print(' 第 1 到 -1 项 是 '，shoplist[1:-1]) 
print(' 开 头 到 结尾 是 '， shoplist[:]) 


# 字符 串 的 切片 
print(' 第 1 到 第 3 个 字符 是 '，name[1:3]) 
print(' 第 2 到 末尾 的 字符 是 '，name[2:]) 
print(' 第 1 到 -1 的 字符 是 '，name[1:-1]) 
print(' 从 头 到 尾 的 字符 是 '，name[:]) 


$ python seq.py 

第 9 项 是 ER 

第 1 项 是 芒果 

第 2 项 是 WY T 

HIM FB 

第 -1 项 是 香蕉 

第 -2 项 是 AF h 

第 0 个 字符 是 S 

第 1 项 到 第 3 项 是 [' 兰 果 '， ' 胡 萝卜 "] 
第 2 项 到 末尾 是 [' 胡 蔓 卜 "， 'FR'] 
第 1 到 -1 项 是 ['ER', ' 胡 萝卜 '] 
开头 到 结尾 是 [ER', 'ER', 'AHb', FR] 


wk a 


第 1 到 第 3 个 字符 是 wa 


ke A 


第 2 到 末尾 的 字符 是 aroop 


Bee 


第 1 到 -1 的 字符 是 waroo 
从 头 到 尾 的 字符 是 swaroop 


它 是 如 何 工 作 的 : 


首先 ， 我 们 看 看 如 何 使 用 索引 来 获得 一 个 序列 的 个 别 项 ， 这 也 称 为 订阅 操作 。 当 你 在 方 括号 
中 指定 一 个 数字 对 应 一 个 序列 中 的 某 项 ， 如 上 所 示 ，Python 会 为 你 取得 序列 中 相对 应 位 置 的 
项 。 记 住 ，Python 从 0 开始 数 数 。 因 此 ， 在 序列 shoplist 中 ， shoplist[6] 取 第 一 项 

和 shoplist[3] 获取 第 四 项 。 


索引 也 可 以 是 负数 ， 在 这 种 情况 下 ， 这 个 位 置 从 序列 的 结尾 开始 计算 。 因 此 ， 
shoplist[-1] 指 的 是 序列 的 最 后 一 项 ， shoplist[-2] 取 倒 数 第 二 个 项 。 


~ 


这 个 切片 操作 是 通过 指定 序列 的 名 称 后 面 加 上 一 个 方 括 号 ， 方 括号 中 有 一 对 可 选 的 用 冒号 分 
隔 的 数 。 注 意 ， 这 非常 类 似 于 你 到 现在 一 直 使 用 的 索引 操作 ， 记 住 这 些 数字 是 可 选 的 但 冒 
不 是 。 


号 


在 切片 操作 中 的 第 一 个 数字 (在 冒号 前 ) 是 切片 开始 的 位 置 ， 第 二 个 数字 (在 冒号 后 ) 是 切片 停止 
的 位 置 。 如 果 第 一 个 数字 没有 指定 ，Python 会 从 序列 开头 开始 ， as 落 ， 
Python 会 在 序列 的 末尾 停止 。 注 意 ， 返 回 的 切片 在 开始 位 置 开始 ， 在 结束 位 置 前 结束 ， 也 就 
是 说 ， 返 回 的 切片 包含 开始 位 置 ， 但 不 包含 结束 位 置 。 


因此 ， shoplist[1:3] 返回 序列 的 切片 从 位 置 1 开 始 ， 包 括 位 置 2， 但 是 在 位 置 3 停止 ， 
此 ， 返 回 两 个 项 目的 切片 。 同 样 ， shoplist[:] 返回 整个 序列 的 一 个 副本 。 


你 也 可 以 使 用 负 位 置 做 切片 。 负 数 用 于 从 序列 的 结尾 开始 。 例 如 ， shoplist[:-1] 将 返回 一 
个 不 包括 序列 最 后 一 项 ， 但 包含 了 其 它 一 切 的 切片 。 


你 也 可 以 为 切片 提供 第 三 个 参数 ， 这 是 切片 的 步 长 (默认 情况 下 ， 步 长 为 1) : 


>>> shoplist = ['#R', 'ER', 'APh', 'FR'] 
>>> shoplist[::1] 
['#R', ‘eR, Mae the '#R'] 


>>> shoplist[::2] 
['#R', APE] 
>>> shoplist[::3] 


Pe, Pel 
>>> shoplist[::-1] 
Pee ae a 


注意 ， 当 步 长 是 2 时 ， 我 们 获得 位 置 0、2、.. .的 项 目 ， 当 步 长 是 3 晨 ， 我 们 获得 位 置 是 0 、 
3 、 等 等 的 项 目 。 


使 用 Python 解 释 器 的 交互 式 提 示 ， 尝 试 指 定 切 片 的 不 同 组 合 ， 以 便 你 可 以 立刻 看 到 结果 。 序 
列 的 一 大 好 处 是 ， 你 可 以 以 同样 的 方式 访问 元 组 、 列 表 和 字符 串 ! 


集合 

集合 是 简单 对 象 的 无 序 集 合 ， 用 于 一 个 集合 中 对 象 的 存在 比 它 的 顺序 或 发 生 多 少 次 更 重要 的 
时 候 。 

使 用 集合 ， 你 可 以 测试 成 员 ， 它 是 否 是 集合 的 子 集 以 及 找到 两 个 集合 的 交集 ， 等 等 。 


>>> bri = Set([ "巴西 ")， /俄罗斯 
>>> ' 印 度 ' in bri 

ue, 

>>> 'usa' in bri 

False 


>>> bric = bri.copy() 
>>> bric.add(' 中 国 ') 

>>> bric.issuperset(bri) 
maue 

>>> bri.remove( ' 俄 罗斯 ' ) 
>>> bri & bric # 或 者 
人 


它 是 如 何 工 作 的 : 


这 个 例子 是 非常 


关联 


当 你 创建 一 个 对 象 ， 并 赋 给 它 


一 般 来 说 ， 你 不 需要 担心 这 


例子 (保存 为 reference.py): 


print(' 简 单 的 分 配 ' ) 
shoplist = ['#R', '£R', 
# my1ist 是 指向 同一 对 象 的 另 一 个 名 字 ! 
mylist = shoplist 
# 我 买 到 了 第 一 项 物品 ， 因 此 我 从 ; 
del shoplist[0] 
print('shoplist', shoplist) 


print('mylist', mylist) 


i 


# 注意 shoplist 和 mylist 都 打印 没有 苹果 


# 证 明 它 们 指向 相同 的 对 象 

print(' 通 过 制作 完整 的 切片 复制 ' ) 
# 通过 制作 完整 的 切片 复制 

mylist = shoplist[:] 

# 移 除 第 一 项 

del mylist[0] 
print('shoplist<', shoplist) 
ae mylist) 

# 注意 ， 现 在 两 个 清单 不 同 


‘Ae h', 


REET 


"印度 中] 


bri.intersection(bric) 


一 个 值 ， 该 变量 


说 ， 变 量 名 称 指 向 你 电脑 中 内 存 中 的 存储 对 象 的 那 部 分 。 这 
文 个 ， 但 是 对 引用 有 一 个 


‘RR 


“的 相同 的 清单 


一 目 了 然 的 ， 因 为 它 涉及 到 学 校 教 的 数学 的 基本 集合 理论 。 


只 是 指向 对 象 ， 并 不 代表 对 象 本 身 ! 也 就 是 
就 是 所 谓 的 把 名 字 绑 定 给 对 象 。 


需要 你 注意 的 微妙 的 影响 。 


输出 : 


$ python reference .py 

简单 的 分 配 

shoplist ['2R', 'A¥h', 'FR"'] 

anes ['ER', (APL, (FA 
制作 完整 的 切片 复制 

Pee ['eR', 'APh', '#8"] 

myliste ['A¥h', 'F@'] 


是 如 何 工 作 的 : 


在 注释 中 有 更 多 有 用 的 解释 。 


记 住 ,如 果 你 想 要 复制 一 个 列表 或 这 种 类 型 的 序列 或 复杂 的 对 象 (而 不 是 简单 的 对 象 如 整数 ) ， 
那么 您 必须 使 用 切片 操作 复制 。 如 果 你 只 是 用 另 一 个 变量 名 指定 ， 两 个 变量 将 “关联 "到 相同 的 
对 象 ， 如果 你 不 小 心 ， 这 可 能 会 引起 麻烦 。 


Per 程 序 员 需要 注意 
记 住 ， 列 表 的 一 个 赋值 语句 并 不 创建 一 个 副本 。 你 必须 使 用 切片 操作 复制 序列 。 


x2 `> 人 大 

关于 字符 串 的 更 多 

之 前 ， 我 们 已 经 详细 讨论 了 字符 串 。 在 这 能 了 解 更 多 吗 ? 嗯 ， ne 首 吗 ， 字 符 串 也 是 对 象 和 
也 有 做 任何 事情 的 方法 一 一 从 检查 的 部 分 字符 囊 到 从 字符 囊 中 分 离 。 


a na es ， 在 下 面 的 例子 中 将 演示 这 个 类 的 一 些 有 用 的 方 
法 ， 这 些 方法 的 完整 列表 ， 请 看 help(str)。 


例子 (保存 为 str_methods.py): 


i >y E Ko kk bot & 
# 这 是 一 个 字符 串 对 象 


name = 'Swaroop' 


if name.startswith('Swa'): 
print(' 是 的 ， 字 符 囊 以 "Swa" 开 始 ') 


if 'a' in name: 
print('2% > €@seFHe"a"') 


if name.find('war') != -1: 
print(' 是 的 ， 它 包含 字符 串 "war"' ) 


delimiter = ' *_' 
mylist = [ "巴西 '， ' 俄 罗斯 '， pRB EEE 
print(delimiter.join(mylist) ) 


输出 : 


$ python str_methods.py 
是 的 ， 字 符 囊 以 "Swa" 开 始 

的 ， 它 包含 字符 囊 "a" 

是 的 ， 它 包含 字符 串 "war" 

巴西 _*_ 俄罗斯 _* 印度 _*_ 中国 


as 





它 是 如 何 工 作 的 : 


在 这 里 ， 我 们 看 到 字符 串 的 很 多 方法 在 起 作用 。 startswith 方法 是 用 来 找 出 字符 串 是 否 以 给 
定 的 字符 串 开 始 的 。 in 操作 符 是 用 来 检查 一 个 给 定 的 字符 串 是 否 是 一 个 字符 串 的 一 部 分 。 


find 方法 用 于 定位 给 定 的 子 字符 串 在 字符 串 内 的 位 置 ， 如 果 不 能 成 功 找到 子 字 符 串 它 返 
回 -1。str 类 也 有 一 个 整洁 的 方法 来 join (连接 ) 一 个 序列 的 字符 串 ， 用 充当 分 隔 符 的 字符 串 连 
接 序列 中 每 个 条 目 ， 返 回 一 个 由 它 生成 的 巨大 的 字符 囊 。 


我 们 详细 探索 了 Python 各 种 内 建 的 数据 结构 ， 写 合理 大 小 的 程序 ， 这 些 数据 结构 是 至 关 重 要 
的 。 


现在 ， 我 们 有 很 多 Python 的 基本 知识 已 经 到 位 ， 下 面 ， 我 们 看 看 如 何 设 计 和 写 一 个 真实 的 
Python 程序 。 


继续 阅读 解决 问题 


解决 问题 


我 们 已 经 探索 过 了 Python 语言 的 各 种 部 分 ， 现 在 我 们 通过 设计 和 编写 一 个 做 有 用 事情 的 程 
序 ， 看 一 看 如 何 将 所 有 这 些 组 合 在 一 起 ， 学 习 如 何 自己 编写 一 个 Python 脚本 可 以 实现 这 个 想 
法 。 


问题 


我 们 想 要 解决 的 问题 是 : 
需要 一 个 为 我 所 有 重要 的 程序 创建 备份 的 一 个 程序 。 


尽管 这 是 一 个 简单 的 问题 ， 但 是 我 们 没有 着 手 解决 这 个 问题 的 足够 的 信息 。 多 一 点 的 分 析 是 
必需 的 ， 例 如 ， 我 们 如 何 指定 哪 一 个 文件 需要 备份 ? 他 们 是 怎样 存储 的 ? 


在 得 当 的 问题 分 析 后 ， 我 们 设计 我 们 的 程序 。 We 在 本 例 中 ， 
我 创建 了 我 希望 ede ra hae 。 如 果 你 做 这 个 设计 ， 你 可 能 不 会 拿 出 同样 的 分 析 ， 
因为 每 个 人 都 有 自己 做 事 的 方式 ， 这 是 非常 好 的 。 


© 在 列表 中 指出 需要 备份 的 文件 和 目录 。 
© 备份 必须 存储 在 一 个 主 备份 目 录 中 。 
© 备份 的 文件 压缩 到 一 个 压缩 文件 中 。 
o 压缩 文件 的 名 称 是 当前 的 日 期 和 时 间 。 
e 在 标准 的 Linux/Unix 发 行 版 上 ， 我 们 默认 使 用 标准 的 zip 命 令 。 注 意 ， 只 要 它 有 一 个 命令 
行 ， 你 可 以 使 用 任何 你 想 要 归档 的 命令 。 
，Windows 用 户 可 以 从 GnuWin32 项 目 页 安装 ， 并 向 你 的 系统 环境 变量 PATH 追加 
C:\Program Files\GnuWin32\bin， 这 和 为 识别 Python 命令 我 们 所 做 的 类 似 


Windows 用 户 


Windows 用 户 可 以 安装 在 GnuWin32 项 目 主页 安装 zip 命令 并 且 将 c:\program 
Files\GnuWin32\bin 添加 到 你 的 环境 变量 PATH 中 ， 就 好 像 我 们 配置 python 命 令 行 一 样 。 


Ax ~~ = 
解决 方案 
由 于 我 们 的 程序 的 设计 现在 相当 稳定 ， 我 们 可 以 写实 现 解决 方案 的 代码 。 


保存 为 backup_ver1.py: 


import os 
import time 


# 工 ， 在 列表 中 指出 需要 备份 的 文件 和 目录 。 

# 在 Windows 中 的 例子 : 

# source = ['"C:\\My Documents"', 'C:\\Code' | 
# 在 Mac OS X 和 Linux 中 的 列子 : 

source = ['"C:\\My Documents"', 'C:\\Code'] 

# 注意 我 们 在 有 空格 的 名 字 的 字符 囊 内 不 得 不 使 用 双 引 号 。 


H 2， 备 份 必须 存储 在 一 个 主 备份 目录 中 。 
# 在 Windows 中 的 例子 : 

# target_dir = 'E:\\Backup' 

# 在 Mac OS X 和 Linux 中 的 例子 : 
target_dir = 'E:\\Backup' 

# 记 住 把 它 改 为 你 要 使 用 的 目录 


# 3. 备份 的 文件 压缩 到 一 个 压缩 文件 中 。 

# 4. 压缩 文件 的 名 称 是 当前 的 日 期 和 时 间 。 

target = target dir + os.sep + \ 
time.strftime('%Y%m%d%H%M%S') + '.zip' 


H 如 果 目 录 不 存在 就 创建 
if not os.path.exists(target_dir): 
os.mkdir(target_dir) # 创建 目录 


#5. 我 们 使 用 zip 命 令 把 文件 压缩 到 一 个 压缩 文件 中 
Zip_command = "zip -qr {0} {1}".format(target, 
' ',join(source) ) 


# 运行 备份 
print("Zip 命 令 为 :") 
print(zip_command) 
print(" 运 行 :") 
if os.system(zip_command) == 
print( ' 成 功 备份 到 ' ，target) 
else: 
print(' 备 份 失败 ') 


输出 : 


$ python backup_ver1.py 
Zip 命 令 为 : 
Zip -r /Users/swa/backup/20140328084844.zip /Users/swa/notes 
运行 : 
adding: Users/swa/notes/ (stored 0%) 
adding: Users/swa/notes/blahi.txt (stored 0%) 
adding: Users/swa/notes/blah2.txt (stored 0%) 
adding: Users/swa/notes/blah3.txt (stored 0%) 
成 功 备 份 到 E:\Backup\20080702185040. zip 


现在 ， 我 们 是 在 测试 我 们 的 程序 能 否 正常 工作 的 测试 阶段 。 如 果 它 不 像 预期 的 那样 , 则 我 们 必 
须 调 试 我 们 的 程序 ， 也 就 是 从 程序 中 去 掉 bug( 错 误 )。 


如 果 上 面 的 程序 不 为 你 工作 ， 将 打印 出 来 的 Zip 命令 为 : 下 面 那 一 行 捞 贝 一 下 ， 然 后 在 
shell(GNU/Linux 和 Mac OS X 中 )/ cmd (Windows 中 ) 里 面 粘贴 ， 看 看 有 哪些 报错 ， 然 后 尝试 修 
复 它 。 如 果 这 个 命令 失败 ,检查 压缩 命令 手册 ， 是 什么 可 能 是 错 的 。 如 果 这 个 命令 成 功 ， 然 后 
检查 Python 程序 是 否 和 上 面 的 程序 完全 匹配 。 


它 是 如 何 工 作 的 : 
你 会 注意 到 ， 我 们 是 如 何以 一 个 循序 渐进 的 方式 将 我 们 的 设计 转换 成 代码 的 。 


我 们 通过 先导 入 和 使 用 os 和 time 模块 ， 然 后 ， 我 们 在 source 清单 中 指定 要 备份 的 文件 和 
目录 ， 目 标 目录 存储 在 变量 target_dir 中 ， 这 是 我 们 要 存储 的 所 有 的 备份 文件 的 地 方 ， 我 们 
将 要 创建 的 压缩 文件 的 名 称 是 使 用 time.strftime() 函数 由 当前 日 期 和 时 间 生 成 的 。 它 也 包 
= .Zip 扩展 名 2 将 存储 在 target_dir 目 录 中 ° 


ER? BE os.sep 的 使 用 -- 目 录 的 分 隔 符 依 你 的 操作 系统 而 定 ， 在 GNU/Linux 和 Unix 中 
是 '/' ， 在 Windows 中 是 '\\' ， 在 Mac OS 中 是 ':' 。 使 用 os.sep 而 不 是 直接 使 用 这 些 字 
符 将 使 我 们 的 程序 更 具 可 移植 性 ， 在 所 有 这 些 系统 上 都 能 工作 。 


time.strftime() 函数 获取 一 个 技术 参数 ， 像 在 上 面 的 程序 中 我 们 已 经 使 用 过 的 。 wy 参数 将 
被 蔡 换 为 带 着 世纪 的 年 份 数 字 。 x%m 参数 将 被 一 个 位 于 01 到 12 的 数字 替换 ， 如 此 等 等 。 这 
种 参数 的 完整 列表 可 Python 参考 手册 中 找到 。 


我 们 创建 目标 文件 的 名 称 zip 文 件 使 用 了 加 法 操作 符 连 接 字符 串 ， 它 将 两 个 字符 串 连 接 在 了 一 
起 ， 并 返回 一 个 新 的 字符 串 。 然 后 ,我 们 创建 一 个 包含 我 们 要 执行 的 命令 的 字符 
串 zip_command 。 你 可 以 通过 在 shell(GNU/Linux 终 端 或 DOS 提 示 符 ) 运 行 来 检查 这 个 命令 的 工 


作 。 


我 们 使 用 的 zip 命令 有 一 些 选项 和 参数 。 -q 选项 用 于 表明 zip 命 令 应 该 quietly( 默 默 地 ) 工 
作 ，-r 选项 指定 zip 命 令 应 该 recursively( 北 归 地 ) 工 作 ， 即 它 应 该 包括 所 有 的 子 目 录 和 文 

件 。 这 两 个 选项 组 合 在 一 起 可 缩写 为 -qr 。 要 创建 的 压缩 文件 名 后 的 选项 后 面 紧 跟 要 备份 的 
文件 和 目录 列表 ， 我 们 使 用 字符 串 的 join 方法 ， 这 种 方法 我 们 已 经 知道 如 何 使 用 ， 

将 source 列表 转换 成 一 个 字符 串 。 

然后 ， 我 们 终于 使 用 os.system 函数 运行 命令 。os.system 函 数 运行 命令 就 仿佛 在 系统 上 也 就 
是 shell 上 运行 它 ， 如 果 命 令 运行 成 功 ， 它 返回 9 ， 和 否则 返回 一 个 错误 号 。 


根据 命令 的 结果 ， 我 们 打印 相应 的 消息 ， 备 份 失败 或 成 功 。 


就 是 这 样 ， 我 们 已 经 创建 了 一 个 备份 我 们 重要 文件 的 一 个 脚本 


Windows 用 户 应 注意 


您 还 可 以 使 用 原始 字符 串 ， 而 不 是 双 反 斜 杠 转 义 序列 ， 例 如 ， 使 
用 'c:\\Documents' 或 r'C:\Documents' 。 然 而 ， 不 要 使 用 'c:\Documents' ， 因为 你 最 终 
用 一 个 未 知 的 转 义 序列 \D © 


现在 ， 我 们 有 一 个 能 够 工作 的 备份 脚本 ， 当 我 们 想 要 备份 文件 时 ， 我 们 可 以 用 它 。 这 被 称 为 
软件 的 操作 阶段 或 部 署 阶段 。 


上 面 的 程序 正常 工作 ， 但 (通常 ) 第 一 个 程序 不 会 像 你 期 望 的 那么 样 工 作 。 例 如 ， 如 果 没 有 正确 
地 设计 程序 或 当 键 入 代码 时 如 果 你 犯 了 一 个 错误 等 ， 可 能 出 现 问 题 。 相 应 地 ， 你 将 不 得 不 回 
到 设计 阶段 或 你 需要 调试 您 的 程序 。 


第 二 版 


第 一 个 版 本 的 脚本 工作 了 。 然 而 ， 我 们 还 可 以 做 一 些 改进 ， 以 便 每 天 工作 得 更 好 。 这 被 称 为 
软件 的 维护 阶段 。 


我 觉得 有 用 的 改进 之 一 是 有 一 个 更 好 的 文件 命名 机 制 在 一 个 目录 中 ， 使 用 时 间作 为 文件 
的 名 称 ， 使 用 当前 日 期 作为 主 备份 目录 中 的 一 个 目录 。 第 一 个 优势 是 ， 你 的 备份 以 分 层 以 方 
式 存储 ， 因 此 它 更 容易 管理 。 第 二 个 优势 是 ， 文 件 名 短 得 多 。 第 三 个 优势 是 单独 的 目录 将 帮 
助 你 检查 每 天 是 否 创 建 了 一 个 备份 ， 如 果 某 一 天 你 备份 了 ， 将 会 创建 一 个 目录 。 





保存 为 backup_ver2.py: 


import os 
import time 


# 工 ， 在 列表 中 指出 需要 备份 的 文件 和 目录 。 

# 在 Windows 中 的 例子 : 

# source = ['"C:\\My Documents"', 'C:\\Code' | 
# 在 Mac OS X 和 Linux 中 的 列子 : 

source = ['"C:\\My Documents"', 'C:\\Code'] 
# 注意 我 们 在 有 空格 的 名 字 的 字符 串 内 不 得 不 使 用 双 引 号 。 


# 2. 备份 必须 存储 在 一 个 主 备份 目录 中 。 
# 在 Windows 中 的 例子 : 

# target_dir = 'E:\\Backup' 

# 在 Mac OS X 和 Linux 中 的 例子 : 
target dir = 'E:\\Backup' 

# 记 住 把 它 改 为 你 要 使 用 的 目录 


# 如 果 目 录 不 存在 就 创建 
if not os.path.exists(target_dir): 
os.mkdir(target_dir) # 创建 目录 


#3. 备份 的 文件 压缩 到 一 个 压缩 文件 中 。 

#4, 在 主 备份 目录 中 创建 一 个 子 目录 ， 名 字 是 当前 的 日 期 。 

today = target dir + os.sep + time.strftime( '%Y%m%d' ) 
# Zip 文 件 的 名 字 是 当前 的 时 间 。 

now = time.strftime('%H%M%S' ) 


# Zip 文 件 的 完整 路 径 
target = today + os.sep + now + '.zip' 


# 如 果子 目录 不 存在 就 创建 它 

if not os.path.exists(today): 
os.mkdir(today) 
print( ' 成 功 创建 子 目 录 : '，today ) 


# 5. 我们 使 用 zip 命令 把 文件 压缩 到 一 个 压缩 文件 中 
zip_command = "zip -qr {0} {1}".format(target, 
' '.join(source)) 


# 运行 备份 
print ("Zip 命 令 为 :") 
print(zip_command) 
print ("运行 :") 
if os.system(zip_command) == 
print(' 成 功 备份 到 '，target) 
elise: 
print(' 备 份 失败 ') 


输出 : 


94 


$ python backup_ver2.py 
成 功 创建 子 目 录 : /Users/swa/backup/20140329 


Zip 命 令 为 : 
zip -r /Users/swa/backup/20140328084844.zip /Users/swa/notes 
运行 : 


adding: Users/swa/notes/ (stored 0%) 

adding: Users/swa/notes/blahi.txt (stored 0%) 

adding: Users/swa/notes/blah2.txt (stored 0%) 

adding: Users/swa/notes/blah3.txt (stored 0%) 
成 功 备份 到 E:\Backup\20080702185040. zip 


它 是 如 何 工 作 的 : 


大 部 分 程序 还 保留 了 原样 ， 变 化 是 ， 我 们 使 用 os.path.exists 函数 检查 在 主 备 份 目录 中 是 否 
存在 以 当前 日 期 为 名 字 的 目录 ， 如 果 不 存在 ， 我 们 使 用 os.mkdir 有 函数 创建 它 


第 三 版 


当 我 们 做 一 些 备份 时 ， 第 二 版 工作 起 来 很 好 了 。 但 当 有 许多 备份 时 ， 我 发 现 区 分 为 什么 备份 
是 很 困难 的 。 例 如 ， 述 做 一 些 重要 的 改变 ， 然 后 我 想 知 道 这 些 变 化 与 压缩 文 
件 的 名 字 有 什么 联系 。 这 个 可 以 通过 为 压缩 文件 的 名 字 附 加 上 一 个 用 户 提供 的 注释 而 轻易 实 
ZI, © 


注意 : : 下 面 的 程序 不 工作 ， 所 VRB Kit ia > A 青 继续 ， 因为 在 这 里 有 一 个 教训 。 保存 为 
backup_ver3.py: 


import os 
import time 


# 工 ， 在 列表 中 指出 需要 备份 的 文件 和 目录 


# 在 Windows 中 的 例子 : 








# source = ['"C:\\My Documents"', 'C:\\Code' ] 
# 在 Mac OS X 和 Linux 中 的 列子 : 

source = ['"C:\\My Documents"', 'C:\\Code'] 
# 注意 我 们 在 有 空格 的 名 字 的 字符 串 内 不 得 不 使 用 双 引 号 
#2. 备份 必须 存储 在 一 个 主 备 份 目录 中 





# 在 Windows 中 的 例子 : 

# target_dir = 'E:\\Backup' 
# 在 Mac OS X 和 Linux 中 的 例子 
target_dir = e 
# 记 住 把 它 改 为 你 要 使 用 的 目录 


# 如 果 目 录 不 存在 就 创 
h Mot ee 
os.mkdir(target_dir) # 创建 目录 





名 字 是 当前 的 日 期 
today = target dir + os.sep + time.strftime( '%Y%m%d' ) 
# Zip 文 件 的 名 字 是 当前 的 时 间 
now = time.strftime('%H%M%S') 
# 提示 用 户 输 入 zip 文 件 名 中 附加 的 注释 
comment = input(' 输 入 注释 --> ') 
# Check if a comment was entered 
if len(comment) == 

target = today + os.sep + now + '.zip' 
else: 

target = today + os.sep + now + '_' + 

comment.replace(' ', '_') + '.zip' 


# 如 果子 目录 不 存在 就 创建 它 
if not os.path.exists(today): 
os.mkdir (today) 
print(' 成 功 创建 子 目录 : '，today) 
#5. 我 们 使 用 Zip 命令 把 文件 压缩 到 一 个 压缩 文件 中 
Zip_command = "zip -qr {0} {1}".format(target, 
' ' join(source) ) 


# 运行 备份 
print("Zip 命 令 为 :") 
print(zip_command) 
print(" 运 行 :") 
if os.system(zip_command) == 
print(' 成 功 备份 到 '，target) 
elise: 
print(' 备 份 失败 ') 


$ python backup_ver3.py 
File "backup_ver3.py", line 25 
target = today + os.sep + now + '_' + 


SyntaxError: invalid syntax 


这 怎么 (不 ) 工作 : 


这 个 程序 不 工作 | Python 说 有 语法 错误 这 意味 着 脚本 不 满足 Python 预计 的 结构 。 当 我 们 观察 
Python 给 出 的 错误 ， 它 还 告诉 我 们 它 检测 到 错误 的 地 方 。 所 以 我 们 从 那 一 行 开 始 调试 我 们 的 
程序 。 


在 仔细 观察 后 ， 我 们 发 现 单 一 的 逻辑 行 被 分 成 两 个 物理 行 ， 但 我 们 没有 指定 这 两 个 物理 行 属 

于 同一 个 逻辑 行 。 基 本 上 ，Python 发 现在 那个 逻辑 行 添加 操作 符 (+) 没 有 任何 操作 对 象 ， 因 此 

不 知道 如 何 继续 。 记 住 ， 我 们 可 以 通过 在 物理 行 的 结束 位 置 使 用 反 儿 杠 指定 当前 行 与 下 一 物 
行 是 连续 的 。 所 以 ， 我 们 要 改正 我 们 的 程序 。 我 们 找到 错误 时 的 这 样 修正 叫做 修复 bug。 


第 四 版 


保存 为 backup_ver4.py: 


import os 
import time 


# 工 ， 在 列表 中 指出 需要 备份 的 文件 和 目录 。 

在 Windows 中 的 例子 : 

source = ['"C:\\My Documents"', 'C:\\Code' ] 
在 Mac OS X 和 Linux 中 的 列子 : 

source = ['"C:\\My Documents 'C:\\Code'] 
# 注意 我 们 在 有 空格 的 名 字 的 字符 串 内 不 得 不 使 用 双 引 号 < 


Sis) JSS ate 


# 2. 备份 必须 存储 在 一 个 主 备份 目录 中 。 
# 在 Windows 中 的 例子 : 

# target dir = 'E:\\Backup' 

# 在 Mac OS X 和 Linux 中 的 例子 : 
target_dir = 'E:\\Backup' 

# 记 住 把 它 改 为 你 要 使 用 的 目录 


H 如 果 目 录 不 存在 就 创建 
if not os.path.exists(target_dir): 
os.mkdir(target_dir) # 创建 目录 


#3. 备份 的 文件 压缩 到 一 个 压缩 文件 中 。 

# 4. 在 主 备份 目录 aan 子 目录 ， 名 字 是 当前 的 日 期 

today = target dir + os.sep + time.strftime( '%Y%m%d' ) 
# Zip 文 件 的 名 字 是 当前 的 时 间 。 

now = time.strftime( '%H%M%S' ) 


# 提示 用 户 输 入 zip 文 件 名 中 附加 的 注释 
comment = input(' 输 入 注释 --> ') 
# Check if a comment was entered 
If len(comment) == 
target = today + os.sep + now + '.zip' 
else: 
target = today + os.sep + now + '_' + \ 
comment.replace(' ', '_') + '.zip' 


# 如 果子 目录 不 存在 就 创建 它 

if not os.path.exists(today): 
os.mkdir (today) 
print( ' 成 功 创建 子 目 录 : '， today) 


ta 巴 文 件 压 缩 到 = 个 压 4 缩 文 文 -4+ 中 


# 5. 我 们 使 用 zip 命 
zip_command = 1 -qr {0} {1}".format(target, 
' ' join(source) ) 


print("Zip 命 令 为 :") 
print(zip_command) 
print(" 运 行 :") 
If os.system(zip_command) == 0: 
print(' 成 功 备份 到 '，target) 
else: 
print(' 备 份 失败 ') 


输出 : 


$ python3 backup_ver4.py 
输入 注释 --> added new examples 
成 功 备份 到 E:\Backup\20080702\202836_added_new_examples.zip 


$ Lae backup_ver4. py 
输入 注释 -- 
成 功 备份 到 人 


它 是 如 何 工 作 的 : 


这 个 程序 现在 工作 了 | 让 我 们 仔细 检查 第 三 版 的 实际 增强 ， 我 们 使 用 input 函数 获取 用 户 的 
注解 ， 然 后 通过 使 用 len 函数 找到 输入 的 长 度 检 查 用 户 确实 输入 了 一 些 东 西 。 如 果 用 户 只 是 
按 enter (〈 回 车 键 ) ， 没 有 输入 任何 东西 (也 许 这 只 是 一 个 常规 备份 或 没有 特殊 的 改变 )， 那 
么 ， 我 们 按照 我 们 之 前 所 做 的 处 理 。 


然而 ， 如 果 提 供 了 一 个 注释 ， 那 么 ， 它 将 附加 到 压缩 文档 名 字 中 、 .zip 扩展 名 前 。 请 注 
意 ， 我 们 将 注释 中 的 空格 用 开 线 正在 取代 空间 在 评论 中 用 下 划 线 这 是 因为 管理 没有 空格 


ws 


的 文件 名 容易 得 多 。 





更 细 化 


第 四 版 对 于 大 多 数 用 户 来 说 是 一 个 令 人 满意 的 工作 脚本 ， 但 总 有 改进 的 余地 。 例 如 ， 您 可 以 
为 程序 包括 一 个 宛 长 级 别 ， 在 那里 你 可 以 指定 一 个 -v 选项 ， 从 而 使 你 的 程序 变 得 更 加 健谈 。 


另 一 个 可 能 的 优化 处 理 是 将 允许 额外 的 文件 和 目录 被 传递 给 该 脚本 的 命令 行 。 我 们 可 
从 sys.argv 列表 得 到 这 些 文件 名 ， 我 们 可 以 使 用 list 类 提供 的 extend 方法 将 它们 添加 到 我 
们 的 source 列表 中 。 


最 重要 的 改进 是 不 使 用 的 创建 文档 的 os.system 方式 ， 而 是 使 用 转 而 使 用 内 建 的 zipfile 或 
tarfile 模 块 创建 文档 。 他 们 是 标准 库 的 一 部 分 ， 在 你 的 计算 机 上 已 经 为 您 提供 使 用 没有 外 部 依 
赖 的 压缩 程序 。 


ki 在 上 面 的 例子 中 ， 纯 粹 是 为 教学 的 目的 ， 我 一 直 使 用 os.system 的 方式 创建 一 个 备 
> 这样 的 例子 对 每 个 人 的 理解 足够 简单 ， 但 不 是 丨 正 足够 的 有 效 。 


你 能 使 用 zipfile 模 块 ， 而 不 是 os.system 调用 尝试 写 第 五 版 吗 ? 


软件 开发 过 程 


我 们 已 经 经 历 了 编写 一 个 软件 过 程 中 的 各 种 阶段 。 这 些 阶段 可 以 概括 如 下 : 


测试 (测试 和 调试 ) 

使 用 (操作 和 部 署 ) 

维护 (优化 ) 编写 程序 的 推荐 方法 是 我 们 创建 备份 脚本 的 过 程 : 做 了 分 析 和 设计 ， 开 始 实 
现 用 一 个 简单 的 版 本 ， 测 试 和 调试 它 ， 来 确保 它 能 按 预期 工作 。 现 在 ， 添 加 你 想 要 的 任 
何 功 能 ， 继 续 重 复 需 要 次 数 的 做 一 试验 循环 。 


oak WN > 


记 住 : 


软件 是 在 成 长 ， 而 不 是 建立 。-- Bill de hÓra 


我 们 已 经 看 到 了 如 何 创 建 我 们 自己 的 Python 程 序 / 脚 本 和 编写 这 种 程序 的 不 同 阶 段 。 你 可 能 会 
发 现 创 建 你 自己 的 程序 就 像 我 们 在 这 一 章 做 的 是 有 用 的 ， 以 便 你 熟悉 Python 以 及 解决 问题 。 


接 下 来 ， 我 们 将 讨论 面向 对 象 编 程 。 


继续 阅读 面向 对 象 编程 


面向 对 象 编程 


到 现在 为 止 ， 在 我 们 编写 的 所 有 程序 中 ， 我 们 围绕 着 函数 ， 也 就 是 处 理 数据 的 语句 块 来 设计 
我 们 的 程序 ， 这 叫做 面向 过 程 的 编程 方式 ， 还 有 一 种 组 织 你 的 程序 的 方式 ， 是 将 数据 和 函数 
组 合 起 来 打包 到 称 为 对 象 的 东西 里 面 ， 这 叫做 面向 对 象 编 程 技术 。 大 多 数 情况 下 ， 你 可 以 使 
用 面向 过 程 的 编程 方式 ， 但 当 你 编写 大 型 程序 或 者 有 一 些 适 用 于 这 种 方式 更 好 的 问题 时 ， 你 
可 以 使 用 面向 对 象 的 编程 技术 。 


类 和 对 象 是 面向 对 象 编程 的 两 个 主要 方面 ， 一 个 类 创建 一 个 新 的 类 型 ， 在 这 里 对 象 是 类 的 一 
个 实例 。 一 个 比喻 ， 你 可 以 有 int 型 变量 ， 换 句 话 说， 存储 整数 的 变量 是 int 类 的 一 个 实例 
(对 象 ) 。 


静态 语言 的 程序 员 应 该 注意 


注意 ， 整 数 甚 至 被 看 作 (int 类 的 ) 对 象 。 这 不 像 在 C+t+ 和 (1.5 版 本 以 前 的 )Java 语 言 中 整数 
是 原始 的 原生 数据 类 型 
关于 类 的 更 多 细节 ， 请 看 help(int)。 
C# 和 Java 程 序 员 将 发 现 这 和 装 箱 和 拆 封 的 概念 相似 。 
对 象 可 以 使 用 属于 对 象 的 普通 变量 存储 数据 。 属 于 一 个 对 象 或 类 的 对 象 被 称 为 字段 。 对 象 也 
可 以 通过 使 用 属于 类 的 函数 有 函数 性 。 这 样 的 函数 被 称 为 类 的 方法 ， o 


因为 它 帮助 我 们 区 分 函数 和 变量 哪些 是 独立 的 ， 那 些 是 属于 一 个 类 或 对 象 的 。 总 体 而 言 
些 字段 和 方法 可 以 被 称 为 类 的 属性 。 


字段 有 两 种 类 型 ， 它 们 可 以 属于 类 的 每 个 实例 /| 对象， 或 属于 类 本 身 。 它 们 被 分 别称 为 实例 变 


量 和 类 变量 。 


创建 一 个 类 使 用 class 的 关键 字 ， 类 的 字段 和 方法 在 一 个 缩 进 块 中 列 出 。 


self 


类 的 方法 与 普通 的 函数 只 有 一 个 特别 的 不 同 点 -- 他 们 必须 有 一 个 额外 的 第 一 个 名 字 、 必 须 被 添 
加 到 参数 列表 的 开始 处 ， 但 你 调用 该 方法 时 ， 不 用 给 此 参数 的 值 ，Python 将 提供 它 。 这 个 特 
别 的 变量 指向 对 象 本 身 ， 按 照 惯例 ， 它 的 名 字 是 self 。 


虽然 ,你 可 以 给 这 个 参数 任何 名 字 ， 强 烈 推荐 你 使 用 名 称 self -- 任 何其 他 的 名 字 肯 定 是 不 清楚 
的 。 使 用 标准 的 名 字 ， 有 许多 优势 -- 你 的 程序 的 任何 读者 将 立即 认 出 它 ， 如 果 你 使 用 self ， 
甚至 专门 的 ide( 集 成 开发 环境 ) 也 可 以 帮助 你 。 


C++/Java/C# 程 序 员 要 注意 

在 Python 中 ， self 相当 于 C++ 中 的 指针 this 、Java 和 C# 中 的 this 引用 。 
你 一 定 很 想 知 道 Python 怎样 给 self 赋值 ， 为 什么 你 不 需要 给 它 一 个 值 。 一 个 例子 会 使 这 个 清 
楚 。 假 设 ， 你 有 一 个 称 为 Myclass 的 类 和 这 个 类 的 实例 称 为 myobject 。 当 你 调用 这 个 对 象 的 


方法 myobject.method(arg1, arg2) 时 ，Python 将 自动 转换 成 Myclass.method(myobject, argi, 
arg2) -- 这 是 关于 self 的 所 有 特殊 之 处 。 





这 也 意味 着 ,如 果 你 有 一 个 不 带 任何 参数 的 方法 ， 那 么 你 还 得 有 一 个 参数 self 。 
表演 类 


最 简单 的 类 可 能 是 如 下 面 的 示例 所 示 ( 另 存 为 simplestclass.py). 


class Person: 


pass # 一 个 空 块 


p = Person() 
print(p) 


输出 : 


$ python3 simplestclass.py 
<__main__.Person object at 0x019F85F0> 


它 是 如 何 工 作 的 : 


我 们 使 用 的 class 语句 和 类 的 名 称 创建 一 个 新 的 类 ， 接 下 来 是 形成 类 的 主体 语句 的 一 个 缩 进 
块 。 在 这 里 ， 我 们 使 用 pass 语 多 表示 这 是 一 个 空 的 块 。 


接 下 来 ， 我 们 使 用 类 名 后 跟 一 对 圆 括号 创建 这 个 类 的 一 个 对 象 /实例 (在 接 下 来 的 部 分 ， 我 们 将 
学 习 更 多 关于 实例 化 的 知识 )。 为 了 验证 ， 我 们 通过 简单 地 打印 它 确认 变量 的 类 型 。 它 告诉 我 
们 ， 在 _main 模块 中 有 一 个 person 类 的 实例 。 


注意 ， 你 的 对 象 存 储 在 计算 机 内 存 的 地 址 也 被 打印 了 。 因 为 Python 找到 任何 地 址 就 存储 对 
象 ， 因而， 在 你 的 计算 机 上 地 址 会 有 所 不 同 。 


对 象 的 方法 


我 们 已 经 讨论 了 类 /对 象 除 了 有 额外 的 self 变 量 外 ， 还 可 以 有 方法 ， 就 像 函 数 。 现 在 ,我 们 将 看 
到 一 个 例子 (另存 为 "的 方法 py”)。 


例子 (保存 为 oop_method.py) : 


class Person: 
def say_hi(self): 
print('#> 33? ') 
p = Person() 


p.say_hi() 
# 上 面 这 两 行 也 可 写成 Person().say_hi() 


$ python oop_method.py 
嗨 ， 你 好 吗 ? 


它 是 如 何 工作 的 : 


在 这 里 我 们 看 到 self 在 起 作用 。 注 意 ， say_hi 方法 不 包含 任何 参数 ， 但 在 函数 定义 中 仍 有 
selifi ° 


”init 方法 


在 Python 中 有 许多 特别 重要 的 方法 名 称 ， 现 在 ， 我 们 看 看 init _ 方法 的 重要 性 。 


类 的 一 个 对 象 一 被 初始 化 ， init 方法 就 运行 。 这 个 方法 对 你 的 对 象 做 任何 初始 化 都 是 有 
用 的 。 


例子 (保存 为 oop_init.py): 


class Person: 
def Imr esek name): 
self.name = name 


def say_hi(self): 
print('#> AM 4F2', self.name) 


p = Person('Swaroop' ) 


p.say_hi() 
# 以 上 两 行 也 可 以 写成 Person('Swaroop').sayHi() 


$ python class_init.py 
io RIJA FE Swaroop 


它 是 如 何 工作 的 : 


在 这 里 ， 我 们 定义 一 个 带 参 数 name (和 通常 的 seit ) 的 init 方法 。 在 这 里 ， 我 们 只 是 创 
建 一 个 新 的 称 作 name 的 字段 。 注 意 ， 尽 管 它们 都 叫 name ， 但 它们 是 两 个 不 同 的 变量 。 
为 self.name 中 的 点 符号 意味 着 "self" 对 象 的 一 部 分 有 个 串 "name" 的 东西 ， 而 另 一 个 name 是 
一 个 局 部 变量 ,因此 没有 问题 。 因 为 我 们 明确 地 表明 我 们 所 指 的 是 哪个 的 名 字 ， 没 有 混乱 。 

最 重要 的 是 。 请 注意 。 我 们 没有 显 式 地 调用 init 方法 ， 而 是 当 创 建 类 的 一 个 实例 时 ， 
通过 在 类 名 称 后 的 括号 内 传递 参数 ， 这 是 该 方法 的 特殊 意义 。 


现在 ， 我 们 可 以 在 我 们 的 方法 中 使 用 self.name 字段 了 ， 在 say_hi 方法 中 已 经 做 了 演示 。 


类 和 对 象 的 变量 


我 们 已 经 讨论 了 类 与 对 象 的 部 分 功能 ( 即 方法 ) ， 现 在 让 我 们 了 解 一 下 数据 部 分 。 数 据 部 分 ， 即 
字段 ， 只 不 过 是 被 绑 定 到 对 象 和 类 的 命名 空间 名 字 的 普通 变量 。 这 意味 着 ， 这 些 名 字 只 有 在 
类 和 对 象 的 环境 内 有 效 。 这 就 是 为 什么 他 们 被 叫做 命名 室 间 的 原因 。 


有 两 种 类 型 的 字段 -- 类 变量 和 对 象 变量 ， 它 们 的 分 类 取决 于 类 和 对 象 分 别 属于 哪 种 变量 。 





类 变量 是 共享 的 他 们 可 以 被 该 类 的 所 有 实例 访问 。 类 变量 只 是 一 个 找 贝 ， 当 任何 一 个 对 
象 改变 一 个 类 变量 时 ， 所 有 的 其 它 实例 都 将 改变 。 


对 象 变量 是 类 的 每 个 对 象 或 实例 所 特有 的 。 了 既然 这 样 ， 每 个 对 象 都 有 自己 的 字段 捞 贝 ， 也 就 
是 说 ， 在 不 同 的 实例 中 ， 它 们 不 共享 ， 同 名 的 字段 没有 任何 联系 。 一 个 例子 能 使 你 容易 理解 
(48 A oop_objvar.py): 


class Robot: 
mun & RA -IEA ` 有 一 个 名 字 o MEN 


WN Ka Z| + 1 3S LA l -E 
# 一 个 类 变量 ， 数 机 器 人 的 数量 


population = 0 


qef na Se mame): 
Wit 1 初始 化 数据 o HUN 
self.name = name 
print(" (初始 化 {})".format(self.name)) 


# 当 创 建 一 个 人 时 ， 机 器 人 人 口 加 1 


Robot.population += 1 


def _ del (self): 
"nm 我 将 要 死 了 o MUN 
print("{0} 正在 被 毁 1" .format(self.name)) 


Robot.population -= 1 


if Robot.population == 
print("{} 是 最 后 一 个 。".format(self.name)) 
else: 
print(" 还 有 {:d} 机 器 人 在 工作 。".format(Robot.population)) 


def say hi(self): 
"num 机 器 人 问候 o 


是 的 ， 它 们 能 做 作 那 个 。""" 
print(" 你 好 ， 我 的 主人 叫 我 " .format (self.name)) 


@classmethod 
def how_many(cls): 
a TERE apA a emu 
print(" 我 们 有 {:d} 个 机 器 人 。" .format(cls.population)) 


droid1 = Robot('R2-D2') 
droidi.say_hi() 
Robot .how_many( ) 


droid2 = Robot('C-3P0') 

droid2.say_hi() 

Robot .how_many( ) 

print("\n 机 器 人 在 这 能 做 一 些 工作 。\n") 
print(" 机 器 人 已 经 完成 了 它们 的 工作 ， 因 此 ， 让 我 们 销毁 它们 。") 
droid1.die() 


droid2.die() 


Robot .how_many( ) 


输出 : 


$ python objvar.py 
(初始 化 R2-D2) 

你 好 ， 我 的 主人 叫 我 
我 们 有 1 个 机 器 人 。 
(初始 化 C-3P0) 

你 好 ， 我 的 主人 叫 我 
我 们 有 2 个 机 器 人 。 


机 器 人 在 这 能 做 一 些 工作 。 


机 器 人 已 经 完成 了 它们 的 工作 ， 因 此 ， 让 我 们 销毁 它们 。 
R2-D2 正在 被 毁 ! 

还 有 1 机 器 人 在 工作 。 

C-3PO 正在 被 毁 ! 

C-3P0 是 最 后 一 个 。 

我 们 有 0 个 机 器 人 。 


它 是 如 何 工 作 的 : 


这 是 一 个 很 长 的 例子 ， 但 有 助 于 展示 类 和 对 象 变量 的 特性 。 在 这 里 ， population By 
于 Robot 类 ， 因 此 是 一 个 类 变量 。 name 变量 属于 对 象 (使 用 self 分 配 )， 因 此 是 一 个 对 象 变 


B 
o 


里 

因此 ， 我 们 提 到 population 类 变量 使 用 Robot.population 而 不 是 self.population 。 我 们 在 
那个 对 象 的 中 提 到 对 象 变量 name 使 用 self.name 符号 。 记 住 对 象 和 类 变量 的 简单 区 别 。 还 请 
注意 ， 一 个 对 象 变量 与 一 个 类 变量 名 字 相 同时 ， 类 变量 将 被 隐藏 

除了 使 用 Robot.population ,我 们 还 可 以 使 用 self. class .population 访问 类 变量 ， 因 为 每 
一 个 对 象 都 可 以 通过 self. class 属性 访问 他 的 类 。 

how many 实际 上 是 一 个 属于 类 而 不 是 对 象 的 方法 ， 这 意味 着 我 们 可 以 将 其 定义 成 
classmethod 或 staticmethod 中 的 任何 一 个 ， 这 取决 于 我 们 是 否 需 要 知道 是 哪个 类 。 因 为 ， 
我 们 不 需要 这 样 的 信息 ， 我 们 主张 staticmethod ° 

我 们 使 用 修饰 符 将 how_many 方法 标识 为 类 方法 。 


我 们 可 以 把 修饰 符 想 象 成 为 一 个 包装 有 函数 的 快捷 方式 ， 所 以 使 用 @classmethod 修饰 符 和 下 面 
的 调用 是 一 样 的 : 


how_many = classmethod(how_many) 


我 们 注意 到 _init _ 方法 使 用 一 个 name 变量 初始 化 Robot 实例 。 在 这 个 方法 中 ， 因 为 还 有 
一 个 机 器 人 被 添加 ,我 们 为 population 计数 加 1。 还 发 现 ， self.name 的 值 是 针对 每 一 个 对 象 
的 ， 这 表明 对 象 变量 的 特性 。 


记 住 ,你 必须 只 有 使 用 seit 引用 同一 对 象 的 变量 和 方法 ， 这 就 是 所 谓 的 属性 引用 。 


在 这 个 程序 中 ,我 们 也 看 到 了 类 和 方法 的 文档 字符 串 的 用 法 。 在 运行 时 我 们 可 能 通过 使 
用 Robot. doc ”访问 类 的 文档 字符 串 ， 使 用 Robot.say _ hi. doc 访问 方法 的 为 文档 字符 
串 o 


在 die 方法 中 ， 我 们 简单 的 将 Robot.population 计数 减 1。 


所 有 的 类 成 员 是 公共 的 ， 一 个 例外 是 : 如 果 你 使 用 的 数据 成 员 的 名 字 使 用 了 arian 
级 如 __privatevar , Python 使 用 命名 修饰 来 有 效 地 使 它 成 为 一 个 私有 变量 。 


因此 ,下 面 的 惯例 是 ， 只 在 对 象 和 类 中 使 用 的 任何 变量 ， 首 先 应 该 以 一 个 下 划 线 开始 ， 其 他 所 
有 的 名 字 都 是 公共 的 ， 且 可 以 被 用 于 其 他 的 类 /对 象 使 用 。 记 住 ， 这 只 是 一 个 惯例 和 不 是 被 
Python 强制 执行 的 (除了 双 下 划 线 前 组 )。 


C++/Javal/C# 程 序 员 要 注意 在 Python 中 ， 所 有 类 成 员 ( 包 括 数据 成 员 ) 是 公共 有 和 所 有 的 
方法 是 虚拟 。 


继承 


面向 对 象 编程 的 一 个 好 处 是 代码 的 重用 ， 一 种 方式 是 通过 继承 机 制 实现 ， 继 承 可 以 被 想像 为 
实现 类 之 间 的 一 种 类 型 和 子 类 型 的 关系 。 


假设 您 想 编写 一 个 大 学 里 教师 和 学 生 记 录 的 程序 ， 他 们 有 一 些 共同 的 特性 ， 如 姓名 、 年 龄 和 
地 址 。 他 们 也 有 特定 的 特性 ， 如 老师 的 工资 、 课 程 和 树叶 和 学 生 的 学 费 、 分 数 。 


您 可 以 为 每 个 类 型 创建 两 个 独立 的 类 ， 并 且 处 理 它们 ， 但 要 添加 一 个 新 的 共同 特征 意味 着 要 
在 这 两 种 独立 的 类 中 都 要 添加 ， 很 快 就 会 变 得 难以 处 理 。 


一 个 更 好 的 方法 是 创 建 一 个 共同 的 类 称 为 SchoolMember ， 然后 从 这 个 类 继承 老师 类 和 学 生 
类 ， 也 就 是 说 它们 成 为 这 个 类 的 子 类 ， 可 以 对 这 些 子 类 添加 特定 的 特征 。 


这 种 方式 有 很 多 优点 ， 如 果 我 们 在 schoolMember 中 添加 /更 改 任何 功能 ， 在 子 类 中 会 自动 反映 
出 来 。 例 如 ， 您 可 以 为 学 生 和 老师 添加 一 个 新 的 身份 证 字段 ， 可 能 通过 直接 把 它们 添加 到 
SchoolMember 类 中 来 实现 。 然 而 ， 子 类 中 的 变化 不 影响 其 他 子 类 。 另 一 个 优点 是 ， 如 果 你 引 
用 SchoolMember 类 的 一 个 老师 或 学 生 对 象 ， 在 某 些 情况 下 如 计算 学 校 成 员 的 数量 时 会 很 有 
用 。 这 就 是 所 谓 的 多 态 性 ， 如 果 父 类 是 预期 的 ， 子 类 在 任何 情况 下 可 以 被 取代 ， 即 对 象 可 以 
当做 父 类 的 一 个 实例 。 


还 观察 到 ， 我 们 重用 父 类 的 代码 ， 在 不 同 的 类 中 我 们 不 需要 重复 ， 而 在 使 用 独立 的 类 的 情况 
下 我 们 不 得 不 重复 。 


在 这 种 ' 情况 下 ? SchoolMember 类 被 称 为 基 类 或 超 类 ° Teacher 和 Student 类 被 称 为 派生 类 或 
子 类 。 


现在 ， 我 们 将 看 到 作为 程序 的 这 个 例子 (保存 为 oop_subclass.py) : 


class SchoolMember: 
We el oe 1"! 
def _ init__(self, name, age): 
self.name = name 
self.age = age 
print(" (初始 化 学 校 成 员 : {})".format(self.name) ) 


defmuelshitse it ic 
Ve on o Vt 
print("Name:'{}' Age: '{}'".format(self.name, self.age), end=" ") 


class Teacher(SchoolMember ): 
WA 
Geonacsstsethname age, salary): 
SchoolMember.__init__(self, name, age) 
self.salary = salary 
print("( 初 始 化 老师 : {})".format(self.name) ) 


def tell(self): 
SchoolMember .tell(self) 
print("Salary: '{0:d}'".format(self.salary) ) 


class Student(SchoolMember ) : 
De eee, UN 
def _init_ (self, name, age, marks): 
SchoolMember.__init__(self, name, age) 
self.marks = marks 
print("( 初 始 化 学 生 : {})".format(self.name) ) 


def telser 
SchoolMember .tell(self) 
print("Marks: '{:d}'".format(self.marks)) 


=e 
ll 


Teacher("Mrs. Shrividya", 40, 30000) 
Student("Swaroop", 25, 75) 


wn 
ll 


# 打印 一 个 罕 行 
print() 


members = [t, s] 

for member in members: 
# 为 Teachers 和 Students 工 作 
member .tell() 


输出 : 


$ python inherit.py 
(初始 化 学 校 成 员 : Mrs. Shrividya) 
(初始 化 老师 : Mrs. Shrividya) 
(初始 化 学 校 成 员 : Swaroop) 
(初始 化 学 生 : Swaroop) 


Name:"Mrs. Shrividya" Age:"40" Salary: "30000" Name:"Swaroop" Age:"25" Marks: "75"~ 


它 是 如 何 工 作 的 : 


使 用 继承 ， 在 类 定义 中 ， 在 类 的 名 称 后 ， 我 们 在 元 组 中 指定 基 类 名 称 ， 接 下 来 ， 我 们 观察 到 
使 用 self 变量 ， 显 式 地 调用 基 类 的 init _ 方法， 这 样 我 们 可 以 初始 化 对 象 的 基 类 部 分 。 
这 是 非常 重要 的 ， 记 住 一 Python 不 会 自动 调用 基 类 的 构造 函数 ， 您 自己 必须 显 式 地 调用 


A o 


我 们 还 观察 到 ， 我 们 可 以 在 类 名 前 加 前 组 调用 基 类 的 方法 ， 然 后 和 其 它 参 数 一 道 传递 给 


self 变 量 值 2 


注意 ， 当 我 们 使 用 schoolMember 类 的 tell 方法 时 ， 我 们 可 以 把 teacher 或 student 的 实例 
作为 SchoolMember 的 实例 。 


同时 ， 观 察 到 子 类 的 tell 方 法 的 调用 ， 不 是 schoolMember 类 的 tell 方法 。 要 理解 这 一 点 的 一 
种 方法 是 ，Python 总 是 在 实际 的 类 型 中 开始 寻找 方法 ， 如 本 例 。 如 果 它 不 能 找到 方法 ， 它 开 
始 按 在 类 定义 中 元 组 中 指定 的 顺序 一 个 接 一 个 地 查找 属于 它 的 基 类 的 方法 。 


术语 提示 -- 如 果 在 继承 元 组 中 不 止 列 出 一 个 类 ， 那 么 它 被 称 为 多 重 继承 。 


在 tell() 方法 中 ， end 参数 是 用 于 来 将 换行 变 为 在 printo 调用 结束 后 以 空格 开始 。 


我 们 已 经 探讨 了 类 和 对 象 的 各 个 方面 以 及 与 之 关联 的 各 种 术语 。 我 们 也 看 到 了 面向 对 象 编程 
的 好 处 和 缺陷 。Python 是 高 度 面向 对 象 ， 从 长 远 看 仔细 理解 这 些 概念 仔细 将 对 你 很 有 帮助 。 


接 下 ， 我 们 将 学 习 如 何 处 理 输入 /输出 和 如 何在 Python 中 访问 文件 。 


继续 阅读 输入 /输出 


输入 输出 


会 有 这 种 情况 ， 你 的 程序 必须 与 用 户 进 行 交 互 。 例 如 ， 你 想 获 取 来 自用 户 的 输入 ， 然 后 打印 
一 些 返 回 的 结果 。 我 们 可 以 分 别 使 用 input() 和 print() 吉 数 来 实现 。 


对 于 输出 ， 我 们 还 可 以 使 用 str( 字 符 串 ) 类 的 各 种 方法 。 例 如 ， 您 可 以 使 用 rjust 方 法 来 获取 一 个 
指定 宽度 的 字符 串 。 更 多 细节 ， 见 help(str) ° 


另 一 个 常见 的 输入 /输出 类 型 是 处 理 文件 。 创 建 、 读 和 写 文件 是 许多 程序 至 关 重 要 的 ， 我 们 将 
在 本 章 探讨 这 方面 。 


> 大 人 
A P RTA 
将 这 个 程序 保存 为 user_input.py: 


def reverse(text): 
return text[::-1] 


def is_palindrome(text): 
return text == reverse(text) 


something = input(' 输 入 文本 : ') 
if (is_palindrome(something) ): 
print(" 是 的 ， 这 是 回 文 ") 
else: 
print(" 不 ， 这 不 是 回 文 ") 


输出 : 


输入 文本 : 蜜蜂 
不 ， 这 不 是 回 文 
输入 文本 : 人 上 人 
是 的 ， 这 是 回 文 


它 是 如 何 工 作 的 : 


我 们 使 用 切片 特性 来 颠倒 文本 。 我 们 已 经 看 到 使 用 seq[a:b] 代 码 获 取 从 a 到 b 来 自序 列 的 切片 。 
我 们 还 可 以 提供 一 个 第 三 个 确定 步 长 的 参数 ， 切 片 默 认 的 步 长 是 1， 它 返回 一 个 连续 文本 的 一 
部 分 。 给 一 个 负 的 步 长 ， 即 -1， 将 以 反 向 返回 文本 。 


input() 辑 数 将 一 个 字符 串 作 为 参数 ， 并 显示 给 用 户 。 然 后 等 待 用 户 输入 和 按 回 车 键 。 一 旦 用 户 
输入 和 按 下 回 车 键 ，input() 函 数 将 返回 用 户 输 入 的 文本 。 


我 们 获取 文本 并 颠倒 它 。 如 果 原 始 文本 和 颠倒 的 文本 是 相等 的 ， 那 么 那个 文本 是 一 个 回 文 。 
家 庭 作 业 


检查 一 个 文本 是 否 是 一 个 回 文 应 该 忽略 标点 符号 、 。 例 如 ，"Rise to vote, 
sir." 也 是 一 个 回 文 ， 但 我 们 当前 的 程序 并 没有 说 它 是 。 你 能 改善 上 述 程序 来 识别 这 个 回 
文 吗 ? 


下 面 的 提示 (不 要 读 ) 


使 用 一 个 元 组 (从 这 里 (http://grammar.ccc.commnet.edu/grammar/marks/marks. 可 
以 找到 所 有 标点 符号 的 一 个 列表 ) 来 保存 所 有 的 禁止 字符 ， 然 后 使 用 会 员 测试 ， 以 确定 
否 应 该 删除 一 个 字符 ， 即 forbidden = (小 '?','.', ...) ° 


se 


为 了 读 写 ， 你 可 以 通过 创建 一 个 file 类 的 对 象 ， 分 别 使 用 read、readline 或 write 方法 来 ， 打 开 
和 使 用 o 能够 读 取 或 写 入 文件 取决 于 文件 打开 时 指定 的 模式 。 最 后 ， 当 你 完成 对 文件 的 
操作 时 ， 你 要 调用 close 方 法 告诉 Python， 文 件 我 们 使 用 完了 。 


例子 (RHA using_file.py): 


poem = '''\ 

当 工 作 完 成 时 

编程 是 有 趣 的 

如 果 想 让 你 的 工作 有 趣 
使 用 Python ! 


rit 


f = open('poem.txt', 'w') # 为 ' 写 w' 打 开 文 件 
f.write(poem) # 文本 写 入 文件 
f.close() # 关闭 文件 


f = open('poem.txt') # 如 果 不 指定 打开 模式 ， 默 认为 ' 读 ' 
while True: 
line = f.readline() 
if len(line) == 0: # 0 长 度 表 示 文 件 结尾 
break 
print(line, end='') 
f.close() # 关闭 文件 


输出 : 


D:> python using_file.py 
当 工 作 完成 时 
编程 是 有 趣 的 
如 果 想 让 你 的 工作 有 趣 
使 用 Python ! 


它 是 如 何 工 作 的 : 


首先 ， 通 过 内 置 的 函数 open， 指 定 文件 名 和 我 们 要 打开 的 模式 ， 打 开 一 个 文件 。 模 式 可 以 是 
读 模式 (P), 写 模式 (WwW'") 或 追加 模式 ('a)。 我 们 也 可 以 指定 是 否 以 文本 格式 ( 忆 ) 或 二 进 制 格 式 ('b') 
读 , 写 或 追加 。 实 际 上 有 更 多 可 用 的 模式 ，help(open) 会 给 你 更 多 的 细节 。 默 认 情况 下 ， 
open() 认 为 是 一 个 以 读 方式 打开 的 文本 格式 的 文件 。 


在 我 们 的 例子 中 ， 我 们 首先 以 写 文 本 格式 打开 文件 ， 使 用 文件 对 象 的 write 方法 写 文件 ， 然 后 ， 
我 们 最 后 close( 关 闭 ) 文 件 。 


接 下 来 ， 为 再 次 阅读 ， 我 们 打开 同一 个 文件 。 我 们 不 需要 指定 一 个 模式 ,因为 ' 读 文本 文件 ' 是 
默认 的 模式 。 我 们 使 用 readline 方 法 在 一 个 循环 中 每 次 读 文件 的 一 行 。 该 方法 返回 一 个 完整 的 
行 ， 包 括 换行 符 结束 时 的 行 。 当 返回 一 个 空 字符 串 时 ， 这 意味 着 我 们 已 经 到 达 文 件 的 末尾 ， 
我 们 ' 打 破 ' 循 环 。 


在 默认 情况 下 ，print() 函 数 在 屏幕 上 自动 换行 打印 文本 。 我 们 是 通过 指定 end=" 禁 止 产 生 新 
行 ， 因 为 从 文件 读 取 的 行 在 结尾 已 经 包含 一 个 换行 符 。 然 后 ， 我 们 最 终 close 文 件 。 


现在 ， 检 查 poem.txt 的 内 容 ， 确 认 程 序 确实 写 入 和 从 那个 文件 读 取 。 


拾取 


Python 提 供 了 一 个 标准 的 模块 称 为 pickle， 使 用 它 你 可 以 在 一 个 文件 中 存储 任何 的 Python 对 
象 ， 然 后 把 它 弄 回来 后 ， 这 就 是 所 谓 的 持续 的 存储 对 象 。 


例子 (保存 为 pickling.py): 


import pickle 

# 我 们 将 要 存储 对 象 的 文件 名 
shoplistfile = 'shoplist.data' 

# 购物 清单 

shoplist = ['#R', 'ER', 'A¥h'] 
# 定 到 文件 

f = open(shoplistfile, 'wb') 
pickle.dump(shoplist, f) # 把 对 象 倒 入 一 个 文件 
f.close() 

del shoplist # 释放 Shop1ist 变 量 

# 从 仓库 读 回 

f = open(shoplistfile, 'rb') 


storedlist = pickle.load(f) # 从 文件 载 入 对 象 
print(storedlist) 


输出 : 


D:> python pickling.py 
['#R', 'ER', (AF EY 
它 是 如 何 工作 的 : 


要 在 文件 中 存储 一 个 对 象 ， 我 们 首先 必须 以 WwW'rite 写 'b'inary 二 进 制 格式 的 方式 open 打 开 文 
件 ， 然 后 调用 pickle 模 块 的 dump 函 数 ， 这 个 过 程 叫 拾取 。 


TŽ > KATE A pickle## k iload BAM FR > KP FALY MAFF © 


我 们 已 经 讨论 了 各 种 类 型 的 输入 /输出 ， 文 件 处 理 和 使 用 pickle 模 块 。 


ET RK RNAS KAR MB © 
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当 你 的 程序 处 于 异常 的 状态 的 时 候 ， 会 抛 出 异常 。 例 如 当 你 想 要 读 取 一 个 并 不 存在 的 文件 的 
时 候 ， 或 者 当 你 要 删除 一 个 正在 运行 的 程序 的 时 候 。 这 些 情况 通过 异常 来 处 理 。 


类 似 的 ， 如 果 你 的 程序 有 一 些 无 效 的 语句 ，Python 也 会 抛 出 错误 提示 告诉 你 这 里 有 一 些 错 


`a 
TR ° 


错误 


我 们 来 看 一 下 一 个 简单 的 print 有 函数 。 如 果 我 们 把 print 写成 了 print 会 怎样 ?注意 大 小 写 
的 错误 。 这 是 Python 会 抛 出 一 个 语法 错误 。 


>>> Print("Hello World") 

Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
NameError: name 'Print' is not defined 
>>> print("Hello World") 

Hello world 


我 们 注意 到 抛 出 了 一 个 NameError 的 错误 ， 以 及 这 个 错误 发 生 的 位 置 。 这 就 是 当 错 误 发 生 的 
时 候 错误 处 理 程序 所 做 的 事情 。 


nds 
Ft it 
我 们 尝试 从 控制 台 读 取 用 户 输入 的 信息 ， 然 后 按 下 [ctrl-d] 看 看 会 发 生 什 么 


>>> s = input( ' 请 输入 --> ') 

Enter something --> Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 

EOFError 


Python 抛 出 了 一 个 名 为 EoFError 的 错误 信息 ， 他 的 是 end of file 的 缩写 (由 ctrl-d 触发 )， 这 
是 我 们 的 程序 刚 开始 的 时 候 没有 预料 到 的 。 


异常 处 理 


我 们 可 以 用 try..except 语句 处 理 异 常 。 我 们 将 正常 执行 的 语句 放 在 try 语 句 块 中 ， 然 后 将 错 
误 处 理 程序 放 到 except 语 句 块 中 。 


例如 (保存 为 exceptions_handle.py ): 


try: 

text = input(' 请 输入 --> ') 
except EOFError: 

print( ' 为 什么 你 按 下 了 EOF? ') 
except KeyboardInterrupt : 

print(' 你 取消 了 操作 ' ) 
elise; 

print(' 你 输入 了 {}'.format(text)) 


输出 为 : 


# 按 下 ctrl +d 
$ python exceptions_handle.py 
请 输入 --> 为 什么 你 按 下 了 EOF? 


# Press ctrl + C 
$ python exceptions_handle.py 
请 输入 --> ^C 你 取消 了 操作 


$ python exceptions_handle.py 
请 输入 --> No exceptions 
你 输入 了 No exceptions 


是 如 何 工作 的 : 


我 们 将 所 有 的 可 能 会 抛 出 异常 /错误 的 语句 写 在 try 块 中 ， 然 后 将 对 应 的 处 理 程序 写 
在 except 块 中 。 每 个 except 语句 可 以 处 理 一 个 特定 的 异常 /错误 ， 或 者 是 一 个 异常 /错误 的 列 
表 (用 括号 表示 ) 。 如 果 没 有 指明 异常 /错误 的 名 字 ， 那 么 他 会 处 理 所 有 的 错误 /异常 。 


注意 ， 每 一 个 try 语句 至 少 应 该 有 一 个 与 之 匹配 的 except 语句 ， 否则 try 语 名 就 没有 意义 
fo 

如 果 你 aes 了 了 寻常/ 错误， 但 是 没有 被 处 理 ， 那 么 Python 语言 就 会 启动 默认 的 异常 处 理 
程序 ， 它 会 中 止 程序 的 运行 ， 打 印 出 错误 的 信息 ， 这 些 内 容 我 们 已 经 看 到 了 © 

你 也 可 以 给 你 的 try..except 写 上 一 个 else 语句 块 ， 当 没有 任何 异常 发 生 的 时 候 就 会 执 


ÍT else 语句 的 内 容 。 


在 下 面 的 例子 中 ， 我 们 将 会 学 习 如 何 获得 异常 对 象 ， 以 便于 我 们 能 够 得 到 关于 异常 的 更 多 的 


信息 。 


抛 出 开 第 


你 可 以 使 用 raise 语句 抛 出 一 个 异常 ， 在 语 旬 中 你 需要 提供 异常 /错误 的 名 称 以 及 抛 出 的 异常 
对 象 。 


你 抛 出 的 异常 /错误 必须 是 一 个 从 Exception 派生 的 类 。 


例如 : (保存 为 exceptions_raise.py ) : 


class ShortInputException(Exception): 
UR PARLOR RRO 
def init__(self, length, atleast): 
Exception. init__(self) 
self.length = length 
self.atleast = atleast 


Vis 
text = input(' 请 输入 --> ') 
if len(text) < 3: 
raise ShortInputException(len(text), 3) 
# Other work can continue as usual here 
except EOFError: 
print('wWhy did you do an EOF on me?') 
except ShortInputException as ex: 
print(('ShortInputException: The input was ' + 
op long, expected at least 172) 
.format(ex.length, ex.atleast)) 
else: 
print('No exception was raised. ') 


输出 为 : 


$ python exceptions_raise.py 
请 输入 --> a 
ShortInputException: The input was 1 long, expected at least 3 


$ python exceptions_raise.py 
请 输入 --> abc 
No exception was raised. 


它 是 如 何 工 作 的 : 


在 这 里 我 们 创建 了 我 们 自己 的 异常 类 。 新 的 异常 类 为 shortInputException 。 他 有 两 个 字 
K: length 表示 输入 内 容 的 长 度 ” atleast 表示 程序 期 望 的 最 小 长 度 


在 except 语 名 中， 我 们 制定 由 as 变量 保存 弹出 的 异常 /错误 的 对 象 。 这 很 类 似 函 数 参 数 在 函 


数 调 用 中 的 作用 。 在 这 个 特殊 的 except HAP > KIRA HM RAY length 和 atleast F 
段 构 造 了 一 个 异常 提示 信息 ， 让 用 户 了 解 为 什么 会 抛 出 这 个 异常 。 


Try ... Finally 


设想 一 下 你 的 程序 需要 读 取 一 个 文件 ， 你 怎样 保证 无 论 是 否 有 异常 抛 出 ， 文 件 对 象 都 被 正确 
的 关闭 呢 ?我们 可 以 使 用 finally 语句 块 做 到 这 一 点 。 


例如 : (保存 为 exceptions_finally.py ) 


import sys 
import time 


f = None 
mye 
f = open("poem. txt") 
# Our usual file-reading idiom 
while True: 
line = f.readline() 
if len(line) == 0: 
break 
print(line, end='') 
sys.stdout.flush() 
print("Press ctrl+c now") 
# To make sure it runs for a while 
time.sleep(2) 
except IOError: 
print("Could not find file poem.txt") 
except KeyboardInterrupt: 


print("!! You cancelled the reading from the file.") 
finally: 
aki? (PE 
f.close() 


print("(Cleaning up: Closed the file)") 


输出 为 : 


$ python exceptions_finally.py 

Programming is fun 

Press ctrl+c now 

AC!! You cancelled the reading from the file. 
(Cleaning up: Closed the file) 


它 是 如 何 工 作 的 : 


我 们 读 取 文 件 的 内 容 ， 只 是 每 读 一 行 就 让 系统 休息 2 秒 ， 我 们 使 用 time.sleep 函数 让 程序 运 
行 慢 一 点 《正常 情况 下 Python 程序 运行 的 飞快 ) 。 当 程序 还 在 运行 的 时 候 ， 按 下 ctrl + c 键 
中 止 程序 的 运行 。 


我 们 注意 到 当 程序 退出 的 时 候 抛 出 了 keyboardinterrupt 蜡 常 。 然 而 ， 在 程序 退出 之 前 ， 执 行 
了 finally 语 句 块 ， 并 且 文 件 对 象 被 正确 的 关闭 了 。 


注意 ， 我 们 在 print 函数 后 面 调用 sys.stdout.flush() 函数 ， 这 样 可 以 及 时 输出 结果 。 


With 语 ^J 
在 try 语句 块 中 获取 资源 ， 然 后 再 finally 语句 块 中 释放 资源 是 一 个 非常 常用 的 程序 段 ， 我 
们 可 以 使 用 with 简化 一 下 程序 的 书写 


例如 : (保存 为 exceptions_using_with.py ) 


with open("poem.txt") as f: 
for line in f: 
print(line, end='') 


它 是 如 何 工作 的 : 


这 段 程序 的 输出 应 该 和 之 前 的 例子 是 一 模 一 样 的 。 唯 一 的 区 别 在 与 我 们 在 with 语 名 中 使 
用 open 函数 打开 文件 ， 这 样 的 话 系 统 会 自动 关闭 这 个 文件 。 


实际 的 处 理 过 程 是 这 样 的 ， with 语句 会 获取 open 函数 返回 的 对 象 ， 我 们 假定 这 个 对 象 名 称 
是 "thefile" 。 


它 总 是 会 在 进 A with 语句 块 之 前 调用 thefile. enter 函数 ， 并 且 总 是 会 会 在 语句 块 的 最 
调用 thefile._exit_ BAX ° 


这 样 的 话 我 们 之 前 在 finally 语句 块 中 写 的 程序 就 会 自动 的 在 exit ”方法 中 被 执行 ， 这 种 
方式 可 以 防止 我 们 频繁 使 用 try. .finally 7% 4] ° 


关于 这 个 主题 更 多 的 讨论 已 经 超出 了 本 书 的 范畴 ， 请 参考 PEP 343 © 


区 结 


名 


4 


本 章 我 们 讨论 了 try..except 和 try..finally 语句 ， 我 们 还 自己 定义 了 一 个 我 们 自己 的 弄 常 
类 型 ， 并 且 在 程序 中 将 其 抛 出 。 


> 我们 将 会 浏览 一 下 Python 标准 库 。 


继续 阅读 标准 库 


异常 处 理 
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示 准 库 


Python 标准 库 包括 大 量 有 用 的 模块 ， ee 就 随 之 安装 了 。Python 标 准 库 能 够 帮 
助 你 快速 解决 很 多 问题 ， 如 果 你 非常 熟悉 这 些 库 可 以 做 什么 。 因 此 熟练 掌握 Python 标准 库 非 
常 重要 。 


我 们 会 快速 浏览 一 下 最 常用 的 标准 库 模 块 ， 如 果 你 想 查看 Python 标准 库 的 完整 文档 ， 请 访问 
标准 库 参 考 ， 这 份 文档 随 着 Python 安装 包 也 安装 在 你 的 电脑 上 。 


让 我 们 开始 浏览 一 些 有 用 的 库 模 块 。 


注意 : 如 果 你 发 现 本 章 讨论 的 问题 太 过 深奥 ， 你 可 以 略 过 本 章 。 然 而 ， 我 强烈 建议 你 在 
熟练 me eres: 之 后 再 返回 头 过 来 看 看 本 章 的 内 容 。 


ak 
sys 模块 
sys 模块 包括 一 些 与 操作 系统 相关 的 功能 。 我 们 已 经 知道 了 sys.argv 可 以 列 出 命令 行 的 参数 
列表 o 
假定 我 们 想 要 检查 我 们 使 用 的 Python 版 本 ， 我 们 可 以 使 用 sys 模块 完成 这 个 工作 。 


>>> import sys 

>>> sys.version_info 

sys.version_info(major=3, minor=5, micro=1, releaselevel='final', serial=0) 
>>> sys.version_info.major == 3 

True 


它 是 如 何 工作 的 


sys 模块 包含 了 一 个 名 为 version_info 的 元 组 ， nee eee ， 其 中 第 一 项 
为 主 版 本 号 ， 我 们 可 以 通过 读 取 这 些 内 容 来 使 用 它 


日 志 模 块 


如 果 你 想 要 输出 调试 信息 ， 或 者 保存 其 他 一 些 重 要 信 7 ， 以 便于 你 可 以 随时 调 取 用 来 检查 你 
的 程序 是 否 按照 你 的 想法 在 运行 。 怎 样 做 才能 保存 这 些 信 息 呢 ? 可 以 使 用 logging 模块 。 


保存 为 stdlib_logging.py : 


import os 
import platform 
import logging 


if platform.platform().startswith( 'Windows'): 
logging file = os.path.join(os.getenv( 'HOMEDRIVE'), 
os.getenv('HOMEPATH'), 
"test .log') 
elise: 
logging file = os.path.join(os.getenv('HOME'), 
"test. rog?) 


print("Logging to", logging_file) 


logging.basicConfig( 
level=logging.DEBUG, 
format='%(asctime)s : %(levelname)s : %(message)s', 
filename=logging_file, 
filemode='w', 


logging.debug("Start of the program") 
logging.info("Doing something") 
logging.warning("Dying now") 


输出 为 : 


$ python stdlib_logging.py 
Logging to /Users/swa/test.log 


$ cat /Users/swa/test.log 

2014-03-29 09:27:36,660 : DEBUG : Start of the program 
2014-03-29 09:27:36,660 : INFO : Doing something 
2014-03-29 09:27:36,660 : WARNING : Dying now 


如 果 你 没有 cat 命令 ， 你 可 以 使 用 一 个 Visual Studio Code 打 开 test.log ° 
它 是 如 何 工作 的 


在 这 个 程序 中 我 们 使 用 了 Python 标准 库 的 三 个 模块 os 模块 用 于 和 操作 系统 进行 交 
互 ， platform 模块 用 于 获取 运行 平台 (如 操作 系统 ) 的 信息 ” logging 模块 用 于 记录 上 日志。 


首先 ， 我 们 调用 platform.platform() 检查 程序 运行 的 操作 系统 (更 详细 的 信息 请 参考 import 
platform; help(platform) ) 。 如 果 是 Windows 操 作 系 统 ， 我 们 通过 指定 主 盘 、 主 目录 和 文件 
名 保存 信息 。 我 们 把 这 三 个 信息 拼接 起 来 ， 就 得 到 了 日 志文 件 的 完整 路 径 。 针 对 其 他 的 操作 

系统 ， 我 们 只 需要 知道 用 户 的 主 目录 以 及 文件 名 就 可 以 得 到 日 志文 件 的 完整 路 径 。 


我 们 使 用 os.path.join() 函数 连接 三 部 分 作为 一 个 字符 串 ， 保 存 日 志文 件 的 完整 路 径 。 之 所 
以 使 用 函数 做 字符 串 连接 而 不 是 采用 字符 串 + 操作 ? 是 因为 我 们 要 确保 这 个 操作 可 以 在 所 有 
的 操作 系统 环境 下 运行 。 

我 们 配置 了 logging 模块 ， 把 所 有 的 信息 用 特定 的 格式 写 到 我 们 指定 的 文件 中 。 

最 后 ， 我 们 可 以 指定 输出 的 信息 的 属性 ， 比 如 调试 、 提 示 、 警 告 或 者 致命 错误 。 程 序 运行 起 
来 之 后 ， 我 们 可 以 通过 查看 这 个 文件 了 解 我 们 的 程序 的 运行 情况 ， 即 使 我 们 的 程序 没有 向 用 
户 输出 信息 全 


Python Module of the Week 
还 有 很 多 其 他 有 用 的 模块 ， 比 如 调试 , 处 理 命令 行 参 数 , 正则 表达 式 等 等 ， 已 经 超出 了 本 书 的 


想 要 继续 学 习 Python 标 准 库 ， 推 荐 大 家 阅读 Doug Hellmann 写 的 非常 棒 的 Python Module of 
the Week， 也 可 以 在 Amazon 购 买 纸 质 的 书籍 ， 当 然 你 也 可 以 直接 阅读 Python 官方 文档 。 


K 


3 be 


Ww? 


¢ 


我 们 浏览 了 Python 标准 库 的 一 些 模块 ， 强 烈 推 荐 大 家 快速 浏览 一 下 Python 标准 库 官 方 文档 ， 
以 便 知 道 有 哪些 模块 时 可 以 拿 来 就 用 的 。 


接 下 来 ， 我 们 探讨 一 下 Python 语言 其 他 方面 的 事情 ， 这 样 可 以 让 我 们 这 本 教程 更 加 完整 。 


继续 阅读 更 多 


更 乡 


迄今 为 止 我 们 已 经 学 习 了 Python 中 的 大 多 数 常 用 知识 。 本 章 中 我 们 会 接触 到 更 多 的 知识 ， 使 
得 我 们 更 全 面 的 掌握 Python 。 


你 是 否 硕 望 过 从 函数 返回 两 个 不 同 的 值 ? 做 到 这 点 使 用 元 组 即 可 。 


>>> def get_error_details(): 
return (2 sdetails?) 


>>> errnum, errstr = get_error_details() 
>>> errnum 

2 

>>> errstr 

"details' 


注意 ， 我 们 使 用 a, b = <some expression> 这 个 表达 式 把 元 组 的 两 个 字段 分 别 赋 给 两 个 变量 。 


这 也 意味 着 在 Python 中 最 快速 的 交换 两 个 变量 的 值得 方法 是 : 


特殊 方法 


有 一 些 诸 如 intit 和 del 的 方法 在 类 中 拥有 特殊 的 含义 。 


特殊 方法 用 于 模拟 某 些 内 建 类 型 的 行为 。 例 如 ， 你 硕 望 为 你 的 类 使 用 x[key] 索引 操作 (就 像 在 
列表 和 元 组 中 那样 )， 那 么 你 仅仅 需要 实现 _ getitem ”方法 就 可 以 了 。 顺 便 提 一 名，Python 
正 是 这 样 实现 list RH | 


一 些 有 用 的 特殊 方法 列 在 下 表 中 。 如 果 你 想 了 解 所 有 的 特殊 方法 ， 详 见 帮助 文档 . 


© Finit (self 222) 


o 在 对 象 第 一 次 被 创建 后 ， 返 回 之 前 调用 。 
e _ del (self) 
o 在 对 象 被 销毁 前 调用 〈 我 们 无 法 预期 这 个 函数 什么 时 候 被 调用 ， 因 此 尽量 避免 使 用 
E) 。 
e _ str (self) 
o 在 使 用 print 函数 或 str() 时 调用 。 
e _]t (self, other) 
o 在 使 用 小 于 运算 符 时 (<) 调 用 。 类 似 的 其 它 运算 符 也 存在 对 象 的 特殊 方法 (+, > 等 )。 


e __getitem_(self, key) 


o 当 使 用 x[key] 索引 操作 时 调用 g 
e __len_ (self) 


o 当 使 用 内 建 len() 函数 时 调用 ， 一 般 用 于 序列 的 对 象 。 


单 语句 块 


我 们 已 经 看 到 每 个 语句 块 都 根据 它 的 缩 进 级 别 将 彼此 区 分 开 。 不 过 有 一 个 例外 ， ee 
块 只 包 条 语句 ， 你 可 以 把 它 放 到 同一 行 ， 例 如 条 件 语 名 或 循环 语句 。 下 面 的 例子 清楚 的 
说 明了 这 


>>> flag = True 
>>> if flag: print('Yes') 


Yes 
注意 上 面 的 单条 语句 被 放置 到 同一 行 而 没有 作为 单独 的 块 。 虽 然 你 利用 这 点 可 以 让 程序 变 的 


更 短 ， 但 我 强烈 建议 你 避免 使 用 这 个 快捷 方式 (除了 错误 检测 )， 主 要 原因 是 使 用 适当 的 缩 进 可 
以 更 方便 的 添加 额外 的 语句 。 


Lambda # ik A, 


lambda 语 多 用 于 在 运行 时 创建 新 的 函数 对 象 。 情况 下 lambda 语句 带 有 一 个 参数 ， 后 面 
跟着 一 个 简单 的 表达 式 作为 函数 体 ， Now 的 返回 值 就 是 新 的 函数 的 返回 值 。 


例如 (保存 为 more_lambda.py ): 


points = [{'x': 2, 'y': 3}, 

EN 
points.sort(key=lambda i: i['y']) 
print(points) 


输出 : 


$ python more_lambda. py 
[ET 
它 是 如 何 工作 的 : 


注意 ， list 对 象 的 sort 函数 有 一 个 名 为 key 的 参数 决定 了 这 个 列表 是 怎样 被 排序 的 (通常 
情况 下 为 升序 或 者 降序 ) 。 在 我 们 的 例子 中 ， 我 们 想 要 有 一 个 自己 的 排序 规则 ， 我 们 需要 写 
一 个 比较 函数 ， 而 不 是 使 用 def 定义 一 个 只 在 这 里 使 用 一 次 的 函数 ， 因 此 我 们 使 用 lambda 表 
达 式 创建 一 个 新 的 函数 。 


列表 解析 
列表 解析 用 于 从 一 个 现 有 的 列表 派生 出 一 个 新 的 列表 。 假设 你 有 一 个 数字 列表 ， 你 想 让 其 中 
所 有 大 于 2 的 元 素 乘 以 2 并 组 成 一 个 新 的 列表 。 类 似 问题 正 是 使 用 列表 解析 的 理想 场合 。 


例子 (保存 为 more_list_comprehension. py ): 


listone = [2, 3, 4] 
listtwo = [2*i for i in listone if i > 2] 


print(listtwo) 


输出 : 


$ python more_list_comprehension. py 
[6, 8] 
它 是 如 何 工 作 的 : 
当 某 些 条 件 满足 时 ( if i > 2 ) 我 们 执行 某 些 操作 ( 2 * i )， 由 此 产生 一 个 新 列表 。 注 意 原始 
列表 并 不 会 被 改变 。 
使 用 列表 解析 的 好 处 在 于 ， 当 我 们 使 用 循环 遍历 元 素 并 将 其 存储 到 新 列表 时 可 以 减少 样板 代 


码 量 。 


函数 接收 元 组 和 列表 


on APA R AY A A TVA BOG BY AAR FH > ABR AK + 和 ** 前 级 。 
需要 在 函数 内 得 到 可 变数 量 的 实 参 时 这 个 方法 很 有 用 。 


>>> def powersum(power, *args): 
"''Return the sum of each argument raised to the specified power.''' 
total = 0 
for i in args: 
total += pow(i, power) 
return total 


>>> powersum(2, 3, 4) 
25 

>>> powersum(2, 10) 
100 


AA args 变量 带 有 * 前 级 ， 因 此 所 有 额外 的 实 参 都 会 被 当做 一 个 元 组 存 入 args PHAR 
数 。 如 果 把 这 里 的 * 换 成 ** ， 则 所 有 额外 的 形 参 都 会 被 当做 一 个 字典 的 键 / 值 对 。 


assertié 4) 


assert 用 于 断言 一 个 表达 式 为 真 。 例 如 ， 你 需要 确保 正在 使 用 的 列表 至 少 有 一 个 元 素 ， 否 则 
引发 一 个 错误 ， 这 种 情况 很 适合 使 用 assert 语句 。 当 assert 语 名 断言 失败 ， 则 引发 一 


个 AssertError ° 


>>> mylist = ['item'] 

>>> assert len(mylist) >= 1 

>>> mylist.pop() 

"Ltem' 

>>> assert len(mylist) >= 1 

Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 

AssertionError 


assert LM Seo SRN RATIARA SG > REAR P LTBI a Bp Ake 
$s 


装饰 器 (decorator) 


装饰 器 是 包装 函数 的 一 种 快捷 方式 。 如 果 你 有 很 多 函数 使 用 了 同样 的 一 段 代码 ， 使 用 装饰 器 
对 函数 进行 


SS) 
包装 会 非常 方便 。 例 如 ， 我 创建 了 一 个 retry 装饰 器 ， 可 以 用 在 任何 函数 中 ， 当 
常 的 时 候 ， headbands ， 每 次 执行 之 间 有 一 个 固定 的 间隔 ， 最 
这 种 设计 在 需要 通过 网 络 进行 远程 调用 的 时 候 非 常 有 用 : 


i 


多 执行 5 次 。 


from time import sleep 

from functools import wraps 
import logging 
logging.basicConfig() 

log = logging.getLogger("retry") 


def retry(f): 
@wraps(f) 
def wrapped_f(*args, **kwargs): 
MAX_ATTEMPTS = 5 
for attempt in range(i, MAX_ATTEMPTS + 1): 
EGY 
return f(*args, **kwargs) 
except: 
log.exception("Attempt %s/%s failed : %s", 
attempt, 
MAX_ATTEMPTS, 
(args, kwargs)) 
sleep(10 * attempt) 
log.critical("All %s attempts failed : %s", 
MAX_ATTEMPTS, 
(args, kwargs)) 
return wrapped_f 


counter = 0 


@retry 
def save_to_database(arg): 
print("Write to a database or make a network call or etc.") 
print("This will be automatically retried if exception is thrown.") 
global counter 
counter += 1 
# This will throw an exception in the first call 
# And will work fine in the second call (i.e. a retry) 
if counter < 2: 
raise ValueError(arg) 


afa name == manne; 





save_to_database( "Some bad value") 


输出 : 


$ python more_decorator.py 
Write to a database or make a network call or etc. 
This will be automatically retried if exception is thrown. 
ERROR: retry:Attempt 1/5 failed : (('Some bad value',), {}) 
Traceback (most recent call last): 
File "more_decorator.py", line 14, in wrapped_f 
return f(*args, **kwargs) 
File "more_decorator.py", line 39, in save_to_database 
raise ValueError(arg) 
ValueError: Some bad value 
Write to a database or make a network call or etc. 
This will be automatically retried if exception is thrown. 


它 是 如 何 工 作 的 : 


请 参考 : 


< 


e http://www.ibm.com/developerworks/linux/library/I-cpdecor.html 
e http://toumorokoshi.github.io/dry-principles-through-python-decorators.html 


Python 2 与 Python 3 的 区 别 


请 参考 : 


e "Six" library 
e Porting to Python 3 Redux by Armin 


Python 3 experience by PyDanny 
Official Django Guide to Porting to Python 3 
e Discussion on What are the advantages to python 3.x? 


Summary 


KERRI T Pythoni S&S 4 o BRAG AAA ES Pythonis S 4 SAR 4F 1 >» 
但 基本 上 已 经 可 以 应 付 在 实践 中 的 绝 大 多 数 情况 。 对 于 你 即将 创建 的 任何 应 用 程序 来 说 这 就 
已 经 足够 了 。 


接 下 来 ， 我 们 来 看 看 阅读 完 本 书 之 后 怎样 继续 学 习 Python 。 


继续 阅读 继续 学 习 
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继续 学 习 


如 果 你 有 认 昌 通 读本 书 之 前 的 内 容 并 且 实 践 其 中 包含 的 大 量 例 程 ， 那 么 你 现在 一 定 可 以 熟练 
ee 。 同时 你 可 能 也 编写 了 一 些 程序 用 于 验证 python 特 性 并 提高 你 的 python 技 能 。 
还 没有 这 样 做 的 话 ， 你 应 该 去 试 试 。 现 在 的 问题 是 接 下 来 应 该 做 什么 ? 


我 建议 你 先 解决 下 面 的 问题 : 


创建 你 自己 的 命令 行 版 本 的 通讯 录 程 序 ， 利 用 它 你 可 以 浏览 修改 删除 或 搜索 诸如 朋友 ， 
家 人 ， 同 事 等 联系 人 和 他 们 的 email 地 址 /或 电话 号 码 等 信息 。 这 些 信 息 必须 存 起 来 以 便 需 
要 时 提取 。 

思考 下 我 们 已 经 学 到 的 各 种 知识 ， 这 个 问题 其 实 相 当 简 单 。 如果 你 感觉 还 是 不 好 下 手 的 话 ， 


这 有 一 些 提示 。 


创建 一 个 表示 联系 人 (persion) 信 息 的 类 。 使 用 字典 存储 联系 人 对 象 并 anes 的 名 字 作 为 字典 
键 。 然 后 利用 pickle 模 块 把 这 些 对 象 永久 存储 到 你 的 硬盘 中 。 最 后 通过 字典 的 内 建 方法 add， 
delete 和 modify 分 别 增 加 删除 修改 联系 人 。 


只 要 你 有 能 力 完 成 这 个 程序 ， 你 就 可 以 自信 的 说 你 是 一 个 python 程 序 员 了 。 那 么 现在 马上 给 
我 发 送 e-mail 好 感谢 我 编写 了 如 此 强大 的 教程 吧 ;-) 当 然 这 步 是 可 选 的 但 我 还 是 希望 你 发 过 来 
同时 ， 也 请 考虑 下 购买 纸 质 书籍 以 支持 本 书 的 持续 发 展 。 


如 果 你 觉得 上 面 的 程序 太 简单 ， 这 还 有 另 一 个 : 
实现 replace 命 令 。 此 命令 用 于 在 给 定 的 文件 列表 中 的 所 有 文件 中 替换 指定 的 字符 串 。 


replace 命 令 可 以 简单 的 执行 字符 串 替 换 也 可 以 复杂 模式 查找 (正则 表达 式 )， 这 取决 于 
你 的 意愿 。 


继续 完成 新 的 项 目 


如 果 你 发 现 上 述 程 序 依然 很 简单 ， 那 么 你 可 以 看 一 下 这 个 更 加 复杂 的 项 目 清 单 ， 用 你 自己 的 
方法 完成 这 些 程序 : https://github.com/thekarangoel/Projects#numbers (同样 的 清单 还 可 以 
参考 Martyr2's Mega Project List). 


更 多 的 项 目 : 


e Exercises for Programmers: 57 Challenges to Develop Your Coding Skills 
e Intermediate Python Projects. 


实例 代码 


学 习 程 序 设 计 最 好 的 办 法 就 是 编写 阅读 大 量 代码 : 


e Python Cookbook 对 于 某 些 种 类 的 问题 Python Cookbook 提 供 了 许多 解决 问题 的 珍贵 技 
巧 和 诀窍 。 此 网 是 每 个 python 用 户 都 必 读 的 。 
e Python Module of the Week 是 另外 一 个 必 读 的 网 站 ， 主 要 是 Python 标 准 库 的 指南 。 


中 .年 


人 口 


The Hitchhiker's Guide to Python! 
The Elements of Python Style 


Python Big Picture 


"Writing Idiomatic Python" ebook (paid) 


视频 


e Full Stack Web Development with Flask 
e PyVideo 


问题 与 解答 


e Official Python Dos and Don'ts 

Official Python FAQ 

e Norvig's list of Infrequently Asked Questions 
Python Interview Q & A 

e StackOverflow questions tagged with python 


教程 


e Hidden features of Python 

e What's the one code snippet/python trick/etc did you wish you knew when you learned 
python? 

e Awaretek's comprehensive list of Python tutorials 


讨论 组 
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如 果 你 被 某 个 问题 难 住 了 ， 也 不 知道 找 谁 求助 ， 那 么 python-tutor list 是 个 提问 的 好 地 方 。 


提问 之 前 需要 先 做 做 功课 ， 你 应 该 自己 先 尝试 解决 问题 ， 然 后 智 意 的 提问 


新 闻 


如 果 你 想 了 解 python 的 最 新 动态 ， 请 关注 Official Python Planet 。 


Sa. 
RR Me 
Python & # 4] Python Package Index 拥 有 数量 巨大 的 开源 库 ， 你 可 以 在 自己 的 程序 中 使 用 它 


安装 和 使 用 这 些 库 ， 你 可 以 使 用 pip 工 具 。 


创建 一 个 网 站 


你 可 以 使 用 Django 创 建 你 自己 的 网 站 ， 本 文 后 面 会 教 你 一 步 一 步 学 习 使 用 Django Web 框 
架 )。 (我 自己 的 喜好 ， 原 文 写 的 是 Flask 框 架 ， 但 是 这 个 框架 动不动 就 好 几 个 月 都 不 更 新 ， 我 
想 还 是 选择 一 个 由 团队 持续 维护 的 框架 比较 靠 谱 ) 


` 


编写 GUI 应 用 程序 


如 果 你 想 使 用 Python 创建 自己 的 GUI 应 用 程序 。 那 么 可 以 使 用 已 绑 定 到 Python 上 的 GUI( 图 形 
用 户 界面 ) 库 。 绑 定 允许 你 在 自己 的 程序 中 使 用 这 些 库 ， 而 库 本 身 是 用 C/C++ 或 其 它 语言 编写 
的 。 


使 用 Python 你 可 以 选择 很 多 种 GUI 库 : 
e Kivy 


o http://kivy.org 
e PyGTK 


o GTK+ 工 具 包 的 python 绑 定 。 它 是 GNOME 的 基础 。GTK+ 含 有 很 多 奇怪 的 用 法 ， 不 
过 一 旦 熟悉 它 你 就 能 够 快速 创建 GUI 应 用 了 。 其 中 Glade 图 形 界面 设计 器 是 必 不 可 少 
的 。GTK+ 的 文档 仍然 完善 中 。GTK+ 在 linux 上 工作 的 很 好 ， 但 其 windows 实 现 仍 未 
完成 。 另外 使 用 GTK+ 你 既 可 以 创建 开源 也 可 以 创建 私有 软件 。 入 门 可 以 阅读 
PyGTK 教 程 . 
e PyQt 


o 这 是 绑 定 到 Python 的 Qt 工具 包 ， 它 是 创建 KDE 的 基石 。 Qt 非常 多 用 ， 功 能 又 很 强 
大 ， 尤 其 是 仰 仗 于 它 的 Qt Designer 与 出 色 的 Qt 文档 。 如 果 你 在 创建 开源 软件 
(GPL'ed) 则 PyQt 是 免费 的 , 相反 创建 商业 的 私有 软件 的 用 户 age 已 了。 从 
Qt4.5 开 始 你 同样 可 以 用 它 创建 非 GPL 软 件 。 作 为 入 门 可 以 阅读 PyQt5 从 入 门 到 精 
通 。 

e wxPython 


o 这 是 绑 定 到 python 的 wxWidgets 工 具 包 。 wxPython 有 一 定 的 学 习 曲 线 。 但 是 具有 很 
强 的 可 移植 性 ， 可 以 运行 在 linux，windows，Mac 甚 至 是 齿 入 式 平台 之 上 。 
WXPython 拥 有 很 多 可 用 的 IDE， 其 中 包括 GUI 设计 器 和 诸如 SPE(Stani 的 python 编 辑 
器 )(http://spe.pycs.net) 和 wxGlade(http://wxglade.sourceforge.net/) 的 开发 工具 。 使 
用 wxPython 你 既 可 以 创建 开源 软件 也 可 以 创建 私有 和 软件。 入 门 可 以 阅读 wxPython 教 
程 (http://zetcode.com/wxpython/) 


GUI 小 结 
更 多 的 选择 参见 GuiProgramming wiki page at the official python website 。 


很 不 幸 ，python 没 有 一 个 标准 GUI 工具 。 我 建议 根据 你 的 情况 选择 上 面 的 工具 。 考 虑 的 第 一 
因素 是 你 是 否 愿 意 付 费 使 用 GUI 工具 。 第 二 你 是 否 希 望 程序 只 运行 在 windows 或 mac 或 linux 还 
是 希望 都 能 运行 。 第 三 对 于 linux 平 台 ， 你 是 一 个 KDE 还 是 一 个 GNOME 用 户 呢 。 


【 译 者 】 : 对 于 国内 用 户 来 说 ， 首 选 PyQt5 平 台 ， 首 先 Qt 工具 是 这 几 个 工具 中 使 用 最 广泛 的 ， 
有 一 些 知名 的 公司 如 LG、 松 下 、ABB 等 都 采用 Qt 作为 GUI 开发 平台 ; 其 次 ，PyQt 是 这 几 个 工 
有 具 中 升级 更 新 最 频繁 的 ， 选 用 一 个 长 期 不 更 新 的 软件 包 会 各 种 奇 苑 的 坑 等 着 你 去 经 历 ; 最 
后 ，Qt 和 PyQt 的 中 文 的 开发 文档 以 及 社区 也 是 最 完整 的 。 还 有 ，GPL 版 权 (此 处 省 去 23412 
F) 。 


更 详细 广泛 的 分 析 ， 见 Python Papers 第 26 页 卷 3 问 题 
1(http://archive.pythonpapers.org/ThePythonPapersVolume3lssue1 .pdf) 


各 种 Python 实现 
一 个 程序 设计 语言 通常 包含 两 部 分 一 语言 和 和 软件。 语言 指出 如 何 编 写 程序 。 而 软件 用 来 运行 
我 们 的 程序 。 


我 们 一 直 在 用 CPython 运 行 我 们 的 程序 ， 之 所 以 称 为 CPython 是 因为 它 是 用 C 语 言 实现 的 并 且 
为 标准 Python 解 释 器 。 


另外 还 有 其 它 的 软件 也 可 以 运行 python 程 序 : 


e Jython 


o 一 个 运行 在 Java 和 平台 的 Python 实现 。 这 意味 着 你 可 以 在 Python 语言 内 部 使 用 Java 库 
和 类 ， 反 之 亦 然 。 
e IronPython 


o 一 个 运行 在 .NET 平 台 的 Python 实现 。 即 你 可 以 在 Python 语言 内 部 使 用 .NET 库 和 类 ， 
e PyPy 


o 一 个 用 python 写 的 python 实 现 ! 这 是 一 个 研究 项 目 ， 用 于 使 之 可 以 快 而 容易 的 改进 
解释 器 ， 因 为 解释 器 本 身 就 是 用 动态 语言 编写 的 。 (而 不 是 类 似 上 面 的 C, java RCH 


等 静态 语言 ) 


除 此 之 外 还 有 CLPython(http://common-lisp.net/project/clpython/) 一 个 Common Lisp 编 写 的 
python 实 现 。Brython 是 一 个 运行 在 JavaScript 解 释 器 之 上 的 IronPython 的 接口 ， 这 可 能 意味 
着 你 可 以 使 用 python( 替 代 JavaScript) 编 写 web 浏 览 器 程序 (“Ajax")。 


以 上 的 每 个 实现 都 有 自己 的 擅长 领域 。 


函数 式 编程 (为 更 高 级 别 用 户 ) 


当 你 要 开始 完成 较 大 规模 的 应 用 程序 的 时 候 ， 你 一 定 要 学 习 一 下 函数 式 编程 范式 ， 这 是 与 我 
们 前 面 所 学 的 面向 对 象 编程 相对 应 的 另外 一 种 编程 范式 : 


e Functional Programming Howto by A.M. Kuchling 

e Functional programming chapter in 'Dive Into Python book 
e Functional Programming with Python presentation 

e Funcy library 

e PyToolz library 


Summary 


现在 我 们 已 经 来 到 本 书 的 结尾 了 。 不 过 据说 ， 结 束 意 味 着 另 一 个 开始 ! 你 现在 是 一 个 满腔 热 
情 的 Python 程序 员 ， 很 可 能 摩 岸 擦 掌 准备 利用 Python 解决 大 量 问题 。 现 在 你 可 以 让 计算 机 自 
动 完成 许多 以 前 无 法 想象 的 事情 或 是 编写 游戏 或 是 更 多 更 多 。 了 既然 如 此 | 那 就 行动 起 来 大 干 
一 场 吧 | 
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附录 : 免费 / 目 由 和 开放 源码 软件 


注意 : 本 章节 是 在 2003 年 完成 的 ， 所 以 有 些 内 容 看 起 来 可 能 有 些 奇怪 :-) 


"Free/Libre and Open Source Software", in short, FLOSS is based on the concept of a 
community, which itself is based on the concept of sharing, and particularly the sharing of 
knowledge. FLOSS are free for usage, modification and redistribution. 


If you have already read this book, then you are already familiar with FLOSS since you have 
been using Python all along and Python is an open source software! 


Here are some examples of FLOSS to give an idea of the kind of things that community 
sharing and building can create: 


Linux: This is a FLOSS OS kernel used in the GNU/Linux operating system. Linux, the 
kernel, was started by Linus Torvalds as a student. Android is based on Linux. Any website 
you use these days will mostly be running on Linux. 


Ubuntu: This is a community-driven distribution, sponsored by Canonical and it is the most 
popular GNU/Linux distribution today. It allows you to install a plethora of FLOSS available 
and all this in an easy-to-use and easy-to-install manner. Best of all, you can just reboot your 
computer and run GNU/Linux off the CD! This allows you to completely try out the new OS 
before installing it on your computer. However, Ubuntu is not entirely free software; it 
contains proprietary drivers, firmware, and applications. 


LibreOffice: This is an excellent community-driven and developed office suite with a writer, 
presentation, spreadsheet and drawing components among other things. It can even open 
and edit MS Word and MS PowerPoint files with ease. It runs on almost all platforms and is 
entirely free, libre and open source software. 


Mozilla Firefox: This is the best web browser. It is blazingly fast and has gained critical 
acclaim for its sensible and impressive features. The extensions concept allows any kind of 
plugins to be used. 


Mono: This is an open source implementation of the Microsoft .NET platform. It allows .NET 
applications to be created and run on GNU/Linux, Windows, FreeBSD, Mac OS and many 
other platforms as well. 


Apache web server: This is the popular open source web server. In fact, it is the most 
popular web server on the planet! It runs nearly more than half of the websites out there. 
Yes, that's right - Apache handles more websites than all the competition (including 
Microsoft IIS) combined. 


VLC Player: This is a video player that can play anything from DivX to MP3 to Ogg to VCDs 
and DVDs to ... who says open source ain't fun? ;-) 


This list is just intended to give you a brief idea - there are many more excellent FLOSS out 
there, such as the Perl language, PHP language, Drupal content management system for 
websites, PostgreSQL database server, TORCS racing game, KDevelop IDE, Xine - the 
movie player, VIM editor, Quanta+ editor, Banshee audio player, GIMP image editing 
program, ... This list could go on forever. 


To get the latest buzz in the FLOSS world, check out the following websites: 


e OMG! Ubuntu! 
e Web Upd8 
e DistroWatch 
Planet Debian 


Visit the following websites for more information on FLOSS: 


e GitHub Explore 
e Code Triage 

e SourceForge 
e FreshMeat 


So, go ahead and explore the vast, free and open world of FLOSS! 
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附录 : 关于 


Almost all of the software that | have used in the creation of this book are FLOSS. 


Birth of the Book 


In the first draft of this book, | had used Red Hat 9.0 Linux as the foundation of my setup and 
in the sixth draft, | used Fedora Core 3 Linux as the basis of my setup. 


Initially, | was using KWord to write the book (as explained in the history lesson). 


Teenage Years 


Later, | switched to DocBook XML using Kate but | found it too tedious. So, | switched to 
OpenOffice which was just excellent with the level of control it provided for formatting as well 
as the PDF generation, but it produced very sloppy HTML from the document. 


Finally, | discovered XEmacs and | rewrote the book from scratch in DocBook XML (again) 
after | decided that this format was the long term solution. 


In the sixth draft, | decided to use Quanta+ to do all the editing. The standard XSL 
stylesheets that came with Fedora Core 3 Linux were being used. However, | had written a 
CSS document to give color and style to the HTML pages. | had also written a crude lexical 
analyzer, in Python of course, which automatically provides syntax highlighting to all the 
program listings. 


For the seventh draft, | was using MediaWiki as the basis of my setup. | used to edit 
everything online and the readers can directly read/edit/discuss within the wiki website, but | 
ended up spending more time fighting spam than writing. 


For the eight draft, | used Vim, Pandoc, and Mac OS X. 


For the ninth draft, | switched to AsciiDoc format and used Emacs 24.3, tomorrow theme, 
Fira Mono font and adoc-mode to write. 


Now 


2016: | got tired of several minor rendering issues in AsciiDoctor, like the ++ in c/c++ 
would disappear and it was hard to keep track of escaping such minor things. Plus, | had 
become reluctant to edit the text because of the complex Asciidoc format. 


For the tenth draft, | switched to writing in Markdown + GitBook format, using the 
Spacemacs editor. 


About the Author 


See 
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我 为 我 编写 的 "Diamond” 软 件 编写 简化 安装 过 程 的 安装 程序 时 ， 我 第 一 次 开始 使 用 Python。 我 
不 得 不 在 Python 还 是 Perl 上 绑 定 Qt 库 进 行 选 择 。 我 在 网 上 做 了 一 些 研究 ， 偶 然 发 现 了 [Eric S 
Raymond 的 一 篇 文章 ] (http://www.python.org/about/success/esr/), Raymond 是 一 个 著名 的 、 
值得 尊 烙 的 黑客 。 其 中 他 谈 道 ，Python 是 如 何 成 为 他 最 喜爱 的 编程 语言 的 。 我 也 发 现 PyQt 的 
绑 定 比 Perl-QT 更 加 成 熟 。 所 以 我 决定 选择 Python 。 


然后 ， 我 开始 搜索 Python 的 优秀 书籍 。 我 没 能 找到 一 本 | 我 确实 找到 了 一 些 O'Reilly 的 书 ， 但 
是 它们 要 么 太 贵 ， 要 么 更 像 是 参考 手册 而 不 是 教程 。 于 是 ， 我 免 强 接受 了 Python 的 随机 文 

档 。 但 是 它 过 于 简单 和 小 巧 。 它 的 确 给 出 了 关于 Python 的 妙计 ， 但 是 不 完整 。 由 于 我 有 编程 
经 验 ， 因 此 我 能 够 对 付 它 ， 但 它 并 不 适合 于 初学 者 。 


在 我 第 一 次 使 用 Python 六 个 月 后 ， 我 安装 了 当时 最 新 的 Red Hat 9.0 Linux， 开 始 使 用 
KWord。 我 对 它 很 兴奋 ， 突 然 冒 出 一 个 想法 ， 用 它 写 一 些 关 于 Python 的 东西 。 我 开始 写 了 几 
页 ， 但 是 很 快 就 有 30 页 之 多 。 然 后 我 认 监 地 将 其 变 成 书 的 形式 ， 使 它 更 有 用 。 经 过 几 次 重 
写 ， 它 已 经 达到 了 作为 学 习 Python 语 言 有 用 教程 的 水 准 。 我 将 这 本 书 作 为 我 的 贡献 捐赠 给 开 
源 社区 。 


本 书 开 始 于 我 在 Python 上 的 学 习 笔 记 ， 尽 管 为 满足 他 人 的 口味 ， 我 做 出 了 大 量 的 努力 ， 但 直 
到 现在 我 依然 这 么 认为 : 


在 开源 的 站 正 精神 中 ， 我 收 到 了 很 多 热心 读者 的 建设 性 意见 、 批 评 和 反馈 ， 这 些 帮 助 我 改进 
了 本 书 。 


本 书 的 状态 


本 书 需要 像 您 这 样 的 读者 的 帮助 ， 指 出 任何 不 足 、 难 以 理解 或 者 错误 之 处 。 请 写 信 给 主要 作 
者 或 者 各 个 译 者 留 下 您 的 意见 和 建议 。 


Appendix: Revision History 


e 4.0 


o 19 Jan 2016 

o Switched back to Python 3 

o Switched back to Markdown, using GitBook and Spacemacs 
e 3.0 


o 31 Mar 2014 
o Rewritten for Python 2 using AsciiDoc and adoc-mode. 


o 03 Aug 2013 
o Rewritten using Markdown and Jason Blevins Markdown Mode 


o 20 Oct 2012 
o Rewritten in Pandoc format, thanks to my wife who did most of the conversion from 
the Mediawiki format 
o Simplifying text, removing non-essential sections such aS nonlocal and 
metaclasses 
1.90 


o 04 Sep 2008 and still in progress 

o Revival after a gap of 3.5 years! 

o Rewriting for Python 3.0 

o Rewrite using http:/Awww.mediawiki.org[MediaWiki] (again) 
1.20 


o 13 Jan 2005 
o Complete rewrite using Quanta+ on Fedora Core 3 with lot of corrections and 
updates. Many new examples. Rewrote my DocBook setup from scratch. 
1.15 


o 28 Mar 2004 
o Minor revisions 
1.12 


o 16 Mar 2004 
o Additions and corrections 
1.10 


o 09 Mar 2004 
o More typo corrections, thanks to many enthusiastic and helpful readers. 
1.00 


o 08 Mar 2004 
o After tremendous feedback and suggestions from readers, | have made significant 


revisions to the content along with typo corrections. 
0.99 


o 22 Feb 2004 


o Added a new chapter on modules. Added details about variable number of 
arguments in functions. 
0.98 


o 16 Feb 2004 
o Wrote a Python script and CSS stylesheet to improve XHTML output, including a 
crude-yet-functional lexical analyzer for automatic VIM-like syntax highlighting of 
the program listings. 
0.97 


o 13 Feb 2004 
o Another completely rewritten draft, in DocBook XML (again). Book has improved a 
lot - it is more coherent and readable. 
0.93 


o 25 Jan 2004 
o Added IDLE talk and more Windows-specific stuff 
0.92 


o 05 Jan 2004 
o Changes to few examples. 
0.91 


o 30 Dec 2003 
o Corrected typos. Improvised many topics. 
0.90 


o 18 Dec 2003 
o Added 2 more chapters. OpenOffice format with revisions. 
0.60 


o 21 Nov 2003 
o Fully rewritten and expanded. 
0.20 


o 20 Nov 2003 
o Corrected some typos and errors. 
0.15 


o 20 Nov 2003 
o Converted to DocBook XML with XEmacs. 
0.10 


o 14 Nov 2003 
o Initial draft using KWord. 


附录 : 版 本 历史 


继续 阅读 附录 : 翻译 


142 


翻译 
There are many translations of the book available in different human languages, thanks to 


many tireless volunteers! 


If you want to help with these translations, please see the list of volunteers and languages 
below and decide if you want to start a new translation or help in existing translation 
projects. 


If you plan to start a new translation, please read the Translation how-to. 


Arabic 


Below is the link for the Arabic version. Thanks to Ashraf Ali Khalaf for translating the book, 
you can read the whole book online at http:/Awww.khaledhosny.org/byte-of-python/index.html 
or you can download it from sourceforge.net for more info see 
http://itwadi.com/byteofpython_arabi. 


Azerbaijani 


Jahangir Shabiyev (c.shabiev@gmail.com) has volunteered to translate the book to 
Azerbaijani. The translation is in progress at https://www.gitbook.com/book/jahangir-sh/piton- 
sancmasi 


Brazilian Portuguese 
There are two translations in various levels of completion and accessibility. The older 
translation is now missing/lost, and newer translation is incomplete. 


Samuel Dias Neto (Ssamuel.arataca@gmail.com) made the first Brazilian Portuguese 
translation (older translation) of this book when Python was in 2.3.5 version. This is no 
longer publicly accessible. 


Rodrigo Amaral (rodrigoamaral@gmail.com) has volunteered to translate the book to 
Brazilian Portuguese, (newer translation) which still remains to be completed. 


Catalan 
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Moises Gomez (moisesgomezgiron@gmail.com) has volunteered to translate the book to 
Catalan. The translation is in progress. 


Moisès Gomez - | am a developer and also a teacher of programming (normally for 


people without any previous experience). 


Some time ago | needed to learn how to program in Python, and Swaroop's work was 
really helpful. Clear, concise, and complete enough. Just what | needed. 


After this experience, | thought some other people in my country could take benefit from 


it too. But English language can be a barrier. 
So, why not try to translate it? And | did for a previous version of BoP. 


| my country there are two official languages. | selected the Catalan language assuming 
that others will translate it to the more widespread Spanish. 


Chinese 


Translations are available at http://woodpecker.org.cn/abyteofpython_cn/chinese/ and 
http://zhgdg.gitcafe.com/static/doc/byte_of_python.html. 


Juan Shen (orion_val@163.com) has volunteered to translate the book to Chinese. 


| am a postgraduate at Wireless Telecommunication Graduate School, Beijing 
University of Technology, China PR. My current research interest is on the 
synchronization, channel estimation and multi-user detection of multicarrier CDMA 
system. Python is my major programming language for daily simulation and research 
job, with the help of Python Numeric, actually. | learned Python just half a year before, 
but as you can see, it's really easy-understanding, easy-to-use and productive. Just as 
what is ensured in Swaroop's book, 'It's my favorite programming language now'. 


'A Byte of Python' is my tutorial to learn Python. It's clear and effective to lead you into a 
world of Python in the shortest time. It's not too long, but efficiently covers almost all 
important things in Python. | think 'A Byte of Python' should be strongly recommendable 
for newbies as their first Python tutorial. Just dedicate my translation to the potential 


millions of Python users in China. 


Chinese Traditional 


Fred Lin (gasolin@gmail.com) has volunteered to translate the book to Chinese Traditional. 


It is available at http://code.google.com/p/zhpy/wiki/ByteOfZhpy. 
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An exciting feature of this translation is that it also contains the executable chinese python 
sources side by side with the original python sources. 


Fred Lin - I'm working as a network firmware engineer at Delta Network, and I'm also a 
contributor of TurboGears web framework. 


As a python evangelist (:-p), | need some material to promote python language. | found 
‘A Byte of Python' hit the sweet point for both newbies and experienced programmers. 
'A Byte of Python' elaborates the python essentials with affordable size. 


The translation are originally based on simplified chinese version, and soon a lot of 
rewrite were made to fit the current wiki version and the quality of reading. 


The recent chinese traditional version also featured with executable chinese python 
sources, which are achieved by my new 'zhpy' (python in chinese) project (launch from 
Aug 07). 


zhpy(pronounce (Z.H.?, or zippy) build a layer upon python to translate or interact with 
python in chinese(Traditional or Simplified). This project is mainly aimed for education. 


French 


Gregory (coulix@ozforces.com.au) has volunteered to translate the book to French. 


Gérard Labadie (gerard.labadie@gmail.com) has completed to translate the book to French. 


German 


Lutz Horn (lutz.horn@gmx.de), Bernd Hengelein (bernd.hengelein@gmail.com) and 
Christoph Zwerschke (cito@online.de) have volunteered to translate the book to German. 


Their translation is located at http://ftp.jaist.ac.jp/pub//sourceforge/a/ab/abop-german.berlios/ 


Lutz Horn says: 
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I'm 32 years old and have a degree of Mathematics from University of Heidelberg, 
Germany. Currently I'm working as a software engineer on a publicly funded project to 
build a web portal for all things related to computer science in Germany.The main 
language | use as a professional is Java, but | try to do as much as possible with 
Python behind the scenes. Especially text analysis and conversion is very easy with 
Python. l'm not very familiar with GUI toolkits, since most of my programming is about 
web applications, where the user interface is build using Java frameworks like Struts. 
Currently | try to make more use of the functional programming features of Python and 
of generators. After taking a short look into Ruby, | was very impressed with the use of 
blocks in this language. Generally | like the dynamic nature of languages like Python 
and Ruby since it allows me to do things not possible in more static languages like 
Java.I've searched for some kind of introduction to programming, suitable to teach a 
complete non-programmer. I've found the book 'How to Think Like a Computer 
Scientist: Learning with Python’, and 'Dive into Python’. The first is good for beginners 
but to long to translate. The second is not suitable for beginners. | think 'A Byte of 
Python' falls nicely between these, since it is not too long, written to the point, and at 
the same time verbose enough to teach a newbie. Besides this, | like the simple 
DocBook structure, which makes translating the text a generation the output in various 
formats a charm. 


Bernd Hengelein says: 


Lutz and me are going to do the german translation together. We just started with the 
intro and preface but we will keep you informed about the progress we make. Ok, now 
some personal things about me. | am 34 years old and playing with computers since 
the 1980's, when the "Commodore C64" ruled the nurseries. After studying computer 
science | started working as a software engineer. Currently | am working in the field of 
medical imaging for a major german company. Although C++ is the main language | 
(have to) use for my daily work, | am constantly looking for new things to learn.Last 
year | fell in love with Python, which is a wonderful language, both for its possibilities 
and its beauty. | read somewhere in the net about a guy who said that he likes python, 
because the code looks so beautiful. In my opinion he's absolutly right. At the time | 


decided to learn python, | noticed that there is very little good documentation in german 


available. When | came across your book the spontaneous idea of a german translation 


crossed my mind. Luckily, Lutz had the same idea and we can now divide the work.| am 


looking forward to a good cooperation! 


Greek 
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The Greek Ubuntu Community translated the book in Greek, for use in our on-line 
asynchronous Python lessons that take place in our forums. Contact @savvasradevic for 
more information. 


Indonesian 


Daniel (daniel.mirror@gmail.com) is translating the book to Indonesian at 
http://python.or.id/moin.cgi/ByteofPython. 


Wisnu Priyambodo (cibermen@gmail.com) also has volunteered to translate the book to 
Indonesian. 


Also, Bagus Aji Santoso (baguzzzaji@gmail.com) has volunteered. 


Italian (first) 


Enrico Morelli (mr.mlucci@gmail.com) and Massimo Lucci (morelli@cerm.unifi.it) have 
volunteered to translate the book to Italian. 


The Italian translation is present at http://www.gentoo.it/Programmazione/byteofpython. 


Massimo Lucci and Enrico Morelli - we are working at the University of Florence (Italy) - 
Chemistry Department. | (Massimo) as service engineer and system administrator for 
Nuclear Magnetic Resonance Spectrometers; Enrico as service engineer and system 
administrator for our CED and parallel / clustered systems. We are programming on 
python since about seven years, we had experience working with Linux platforms since 
ten years. In Italy we are responsible and administrator for www.gentoo.it web site for 
Gentoo/Linux distrubution and www.nmr.it (now under construction) for Nuclear 
Magnetic Resonance applications and Congress Organization and 

Managements. That's all! We are impressed by the smart language used on your Book 
and we think this is essential for approaching the Python to new users (we are thinking 
about hundred of students and researcher working on our labs). 


Italian (Second) 


An Italian translation has been created by Calvina Bice & colleagues at 
http://besthcgdropswebsite.com/translate/a-byte-of-python/. 


Japanese 


D 


Shunro Dozono (dozono@gmail.com) is translating the book to Japanese. 


Korean 
Jeongbin Park (pjb7687@gmail.com) has translated the book to Korean - 
https://github.com/pjb7687/byte_of_python 


| am Jeongbin Park, currently working as a Biophysics & Bioinformatics researcher in 


Korea. 


A year ago, | was looking for a good tutorial/guide for Python to introduce it to my 
colleagues, because using Python in such research fields is becoming inevitable due to 
the user base is growing more and more. 


But at that time only few Python books are available in Korean, so | decided to translate 
your ebook because it looks like one of the best guides that | have ever read! 


Currently, the book is almost completely translated in Korean, except some of the text in 
introduction chapter and the appendixes. 


Thank you again for writing such a good guide! 


Mongolian 


Ariunsanaa Tunjin (luftballons2010@gmail.com) has volunteered to translate the book to 
Mongolian. 


Update on Nov 22, 2009 : Ariunsanaa is on the verge of completing the translation. 
Norwegian (bokmal) 


Eirik Vageskar is a high school student at Sandvika videregaende skole in Norway, a 
blogger and currently translating the book to Norwegian (bokmal). 


附录 : 翻译 


Eirik Vageskar: | have always wanted to program, but because | speak a small 
language, the learning process was much harder. Most tutorials and books are written 
in very technical English, so most high school graduates will not even have the 
vocabulary to understand what the tutorial is about. When | discovered this book, all my 
problems were solved. "A Byte of Python" used simple non-technical language to 
explain a programming language that is just as simple, and these two things make 
learning Python fun. After reading half of the book, | decided that the book was worth 
translating. | hope the translation will help people who have found themself in the same 
situation as me (especially young people), and maybe help spread interest for the 
language among people with less technical knowledge. 


Polish 


Dominik Kozaczko (dominik@kozaczko.info) has volunteered to translate the book to Polish. 
Translation is in progress and it's main page is available here: Ukas Pythona. 


Update : The translation is complete and ready as of Oct 2, 2009. Thanks to Dominik, his 
two students and their friend for their time and effort! 


Dominik Kozaczko - I'm a Computer Science and Information Technology teacher. 


Portuguese 


Fidel Viegas (fidel.viegas@gmail.com) has volunteered to translate the book to Portuguese. 


Romanian 


Paul-Sebastian Manole (brokenthorn@gmail.com) has volunteered to translate this book to 
Romanian. 


Paul-Sebastian Manole - I'm a second year Computer Science student at Spiru Haret 
University, here in Romania. I'm more of a self-taught programmer and decided to learn 
a new language, Python. The web told me there was no better way to do so but read "A 
Byte of Python". That's how popular this book is (congratulations to the author for 
writing such an easy to read book). | started liking Python so | decided to help translate 
the latest version of Swaroop's book in Romanian. Although | could be the one with the 
first initiative, I'm just one volunteer so if you can help, please join me. 


Russian 
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Vladimir Smolyar (v_2e@ukr.net) has completed a Russian translation at 
http://wombat.org.ua/AByteOfPython/. 


Ukranian 


Averkiev Andrey (averkiyev@ukr.net) has volunteered to translate the book to Russian, and 
perhaps Ukranian (time permitting). 


Serbian 


"BugSpice" (amortizerka@gmail.com) has completed a Serbian translation: 
This download link is no longer accessible. 


More details at http://forum.ubuntu-rs.org/Thread-zagprljaj-pitona. 


Slovak 


Albertio Ward (albertioward@gmail.com) has translated the book to Slovak at 
http://www.fatcow.com/edu/python-swaroopch-si/ : 


We are a non-profit organization called "Translation for education". We represent a 
group of people, mainly students and professors, of the Slavonic University. Here are 
students from different departments: linguistics, chemistry, biology, etc. We try to find 
interesting publications on the Internet that can be relevant for us and our university 
colleagues. Sometimes we find articles by ourselves; other times our professors help us 
choose the material for translation. After obtaining permission from authors we translate 
articles and post them in our blog which is available and accessible to our colleagues 
and friends. These translated publications often help students in their daily study 
routine. 


Spanish 


Alfonso de la Guarda Reyes (alfonsodg@ictechperu.net), Gustavo Echeverria 
(gustavo.echeverria@gmail.com), David Crespo Arroyo (davidcrespoarroyo@hotmail.com) 
and Cristian Bermudez Serna (crisbermud@hotmail.com) have volunteered to translate the 
book to Spanish. 


Gustavo Echeverria says: 


| work as a Software engineer in Argentina. | use mostly C# and .Net technologies at 
work but strictly Python or Ruby in my personal projects. | knew Python many years 
ago and | got stuck inmediately. Not so long after knowing Python | discovered this 
book and it helped me to learn the language. Then | volunteered to translate the book 
to Spanish. Now, after receiving some requests, I've begun to translate "A Byte of 
Python" with the help of Maximiliano Soler. 


Cristian Bermudez Serna says: 


| am student of Telecommunications engineering at the University of Antioquia 
(Colombia). Months ago, i started to learn Python and found this wonderful book, so i 


volunteered to get the Spanish translation. 


Swedish 


Mikael Jacobsson (leochingkwake@gmail.com) has volunteered to translate the book to 
Swedish. 


Turkish 


Türker SEZER (tsezer@btturk.net) and Bugra Cakir (bugracakir@gmail.com) have 
volunteered to translate the book to Turkish. "Where is Turkish version? Bitse de okusak." 
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参与 翻译 工作 


The full source of the book is available from . 

Please fork the repository. 

Then, fetch the repository to your computer. You need to know how to use Git to do that. 
Read the GitBook documentation, esp. the Markdown section. 

Start editing the .md files to translate to your local language. 

Sign up on GitBook.com, create a book and you can see a beautifully rendered website, 
with links to download PDF, EPUB, etc. 


oak WN >= 


继续 阅读 反馈 


The book needs the help of its readers such as yourselves to point out any parts of the book 
which are not good, not comprehensible or are simply wrong. Please write to the main 
author or the respective translators with your comments and suggestions. 


Django Step Sy Step 


Django Step By Step 


H K 


第 一 讲 A T django” 而 生 展 的 人 ， 有 兴趣 看 一 看 ， 程 序 如 何 从 
简单 到 复杂 


第 二 讲 生成 一 个 web form 用 来 做 加 法 的 简单 例子 

第 三 讲 使 用 Template 的 简单 例子 

第 四 讲 生成 csv 格 式 文件 

第 五 讲 Session 的 示例 ， 开 始 进入 数据 库 的 世界 

第 六 讲 一 个 wiki 的 例子 
第 七 讲 一 个 通讯 录 的 例子 

第 八 讲 为 通讯 录 增加 文件 导入 和 导出 功能 

第 九 讲 通讯 录 的 美化 ， 使 用 克 套 模板 ， 静 态 文件 ， 分 页 处 理 等 
第 十 讲 扩展 django 的 模板 ， 自 定义 filter， 进 一 步 美 化 

第 十 一 讲 用 户 管理 和 使 用 authentication 来 限制 用 户 的 行为 

第 十 二 讲 搜索 功能 的 实现 和 Apache 上 的 部 署 体验 

第 十 三 讲 简单 的 Ajax 的 实现 (一 )，MochiKit 的 一 些 使 用 

第 十 四 讲 简单 的 Ajax 的 实现 (二 )， 使 用 SimpleJson 来 交换 数据 

第 十 五 讲 i18n 的 一 个 简单 实现 
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第 十 六 讲 自 定 义 Calendar Tag 


第 十 七 讲 View, Template, Tag 之 问 的 关系 
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Django Step by Step (一 ) 


1 开篇 


Django 是 新 近 出 来 的 Rails 方式 的 web 开发 框架 。 在 接触 Django 之 前 我 接触 过 其 它 几 种 
Python 下 的 web framework, 但 感觉 Karrigell 是 最 容易 上 手 的 。 不 过 从 我 个 人 的 感觉 
上 来 看 ， 它 的 功能 更 强大 ， 社 区 也 很 活跃 ， 高 手 众 多 ， 发 展 也 是 极为 迅速 。 我 个 人 很 看 好 。 
但 在 学 习 的 过 程 中 感觉 与 Karrigell 的 开发 体验 差距 比较 大 。 那 么 我 想 ， 与 Django 的 
开发 体验 到 底 差别 在 哪里 ， 为 什么 Django 给 我 的 感觉 还 不 是 那么 清晰 直观 呢 ? 


我 想 可 能 是 因为 Django 的 教程 过 于 想 把 它 的 特色 展示 给 大 家 ， 因 此 ， 对 于 初学 者 来 说 一 下 子 
接触 的 东西 太 多 ， 反 倒 让 大 家 很 难 理解 。 于 是 我 想 从 最 最 简单 的 例子 做 起 ， 并 且 记 录 下 来 ， 
并 且 将 其 形成 一 个 教程 。 


2 Karrigell 的 入 门 体验 


不 知道 大 家 是 否 了 解 Karrigell ， pee. E framework 框架 ， 在 发 现 它 之 后 我 写 了 
不 少 关于 代码 分 析 的 文章 。 因 为 它 开发 方式 非常 ， 特别 是 方便 ， 对 它 的 印象 也 非常 好 。 
只 不 过 开发 web 不 是 我 的 主 业 ， 因 此 实践 得 少 。 Ta Zoom.Quiet 在 这 方面 已 经 有 所 建树 ， 
大 家 可 以 去 wiki 上 学 习 他 写 的 “问卷 调查 生成 系统 "的 快速 体验 教程 。 这 是 一 个 非常 详细 的 过 
程 ， 而 且 还 有 图 。 


那么 为 什么 Karrigell 开发 让 人 感觉 到 方便 呢 ? 我 想来 想 去 可 能 有 这 些 原因 : 


现在 的 开发 ， 特 别 是 Python 的 开发 ， 我 们 都 喜欢 而 且 习 惯 边 学 边 做 ， 从 小 做 起 ， 一 边 做 一 边 
aa? 因此 从 小 入 手 ， 步 步 有 体验 ， 这 就 是 Python 开发 的 特点 。 我 们 不 会 一 上 来 就 写 出 非 
常 大 的 东西 ， 而 是 写 一 点 ， 和 运行 一 下 ， 调 试 一 下 ， 再 写 一 点 ， 和 运行 一 下 ， 调 试 一 下 ， 慢 慢 地 
— 。 这 种 方式 非常 典型 ， 也 更 为 大 多 数 人 习惯 。 而 Karrigell 则 基本 上 就 是 这 样 的 。 安 
装 完 Karrigell ， 然 后 就 可 以 运行 了 。 不 用 写 程 序 ， 写 个 简单 的 html 页 面 ， 直 接 放 在 它 的 
webapps A vee 这 是 2.2 版 ， 如 果 你 没有 修改 karrigell.ini 的 root 参 数 的 缺 省 目录 )， 在 浏览 器 就 

可 以 看 了 。 就 这 么 简单 。 写 程序 也 简单 呀 ， 写 个 hello.py， 里 面 就 是 : 


print “Hello, Karrigell!" 


这 就 是 最 简单 的 web 体 验 。 oe ， 你 就 可 以 一 点 点 地 开始 学 它 的 web 知 识 了 。 
少 成 多 。 Karrigell 中 是 就 是 这 样 。 


3 Django 的 入 门 体验 


但 Django 呢 ? 如 果 说 最 简单 的 web 体 验 Hello, Django! 如 何 写 呢 ? 决 不 会 象 Karrigell 那样 简 
单 ， 只 从 它 提供 的 教程 来 看 ， 你 无 法 在 安装 后 非常 Easy 地 写 出 一 个 Hello, Django! 的 例子 ， 

为 有 一 系列 的 安装 和 准备 工作 要 做 。 那 么 下 面 我 把 我 所 尝试 写 最 简单 的 Hello, Django! 的 例 
子 写 出 来 。 


请 注意 ， 我 测试 时 是 在 Windows 环 境 下 进行 的 。 


3.1 安装 


C:\>pip install django 


3.2 生成 项 目 目录 


因为 Karrigell 可 以 直接 开发 ， 因 此 放 在 哪里 都 可 以 。 而 Django 是 一 个 框架 ， 它 有 特殊 的 配 
置 要 求 ， 因 此 一 般 不 需要 手工 创建 目录 之 类 的 工作 ，Django 提供 了 django-admin.py 可 以 做 
这 件 事 。 


C:\>django-admin startproject newtest 


这 样 就 在 当前 目录 下 创建 了 一 个 newtest 目录 ， 进 去 入 可 以 看 到 这 样 的 目录 结构 : 


newtest/ 
manage. py 
newtest/ 
__init__.py 
settings.py 
urls.py 
wsgi.py 


这 个 newtest 将 是 我 们 以 后 工作 的 目录 ， 许 多 讲解 都 是 基于 这 个 目录 的 。 


最 外 层 的 newtest/ 目 录 包 括 了 项 目的 全 部 文件 ， 这 个 目录 名 可 以 随意 修改 。 


manage.py : 提供 简单 化 的 django-admin.py 命令 ， 特 别 是 可 以 自动 进行 
DJANGO_SETTINGS MODULES 和 PYTHONPATH 的 处 理 ， 而 没有 这 个 命令 ， 处 理 上 
面 环境 变量 是 件 麻 烦 的 事情 


newtest/ 子 目录 是 项 目 实际 运行 所 依赖 的 Python 包 。 目 录 名 就 是 Python 包 名 ， 如 果 需 要 
导入 子 目 录 的 模块 就 需要 使 用 这 个 名 字 ( 例 如 mysite.urls)。 


newtest/init.py : 表示 这 是 一 个 Python 44 & 
newtest/settings.py : 它 是 django 的 配置 文件 


newtest/uls.py : _ url 映射 处 理 文件 Karrigell 没有 这 种 机 制 ， 它 通过 目录 /文件 /方法 来 自 
动 对 应 ， 而 Django 的 url 映 射 是 url 对 于 某 个 模块 方法 的 映射 ， 目 前 不 能 自动 完成 


newtest/wsgi.py : 如 果 需 要 将 项 目 部 署 到 兼容 WSGI 的 Web 服 务 器 上 ， 这 个 文件 就 是 入 
Vo 


虽然 django-admin.py 为 我 们 生成 了 许多 东西 ， 而 且 这 些 东 西 在 以 后 的 开发 中 你 都 需要 就 
悉 ， 但 现在 我 们 的 目标 是 最 简单 的 体验 ， 就 认为 我 们 不 需要 知道 它们 都 有 什么 用 吧 。 


项 目 创 建 好 了 ， 那 么 我 们 可 以 启动 服务 器 吗 ? Django 为 了 开发 方便 ， 自 带 了 一 个 用 于 开发 的 


web server ° 


3.3 Æ 4) web server 
BAT > AA IL Hello, Django! 在 哪里 呢 。 是 的 ， 我 只 是 想 看 一 看 ，Dijango 能 否 启 动 。 


C:\newtest\>python manage.py runserver 


一 旦 出 现 : 


Performing system checks... 
System check identified no issues (0 silenced). 


You have unapplied migrations; your app may not work properly until they are applied. 
Run 'python manage.py migrate' to apply them. 


November 25, 2016 - 15:50:53 

Django version 1.10, using settings 'mysite.settings' 
Starting development server at http://127.0.0.1:8000/ 
Quit the server with CONTROL-C. 


说 明 Django WERT HAAR PA-T > A-*+RTR D> HARAT ° 


It worked! 


Congratulations on your first Django-powered page. 


Of course, you haven’ t actually done any work yet. Next, start your first app by rumning python manage. py startapp [app_label]. 


You’ re seeing this message because you have DEBUG = True in your Django settings file and you haven't configured any URLs. Get to work! 





3.4 增加 一 个 helloworld 的 app 吗 ? 


在 Django 中 绝 大 多 数 应 用 都 是 以 app 形 式 存在 的 ， 但 一 定 要 加 吗 ? 其 实 并 不 需要 。 在 Django 
中 ， 每 个 app 就 是 一 个 子 包 ， 申 正 调用 时 需要 通过 URL Dispatch 来 实现 url 与 模块 方法 的 映 
射 。 这 是 Django 的 一 大 特色 ， 但 也 是 有 些 麻 烦 的 地 方 。 不 用 它 ， 你 无 法 发 布 一 个 功能 ， 如 果 
在 Django 中 存在 一 种 缺 省 的 简单 映射 的 方式 ， 这 样 我 想 可 以 大 大 提高 Django 的 入 门 体验 

E o 


因此 根据 URL Dispatch 的 机 制 ， 我 们 只 要 保证 Django 可 以 在 正确 的 地 方 找到 方法 进行 调用 
即 可 。 那 么 我 们 就 根本 不 去 创建 一 个 app 了 。 


在 newtest 子 目录 下 创建 一 个 文件 helloworld.py 内 容 为 : 


from django.http import HttpResponse 


def index(request): 
return HttpResponse("Hello, Django.") 


3.5 修改 urls.py 





from django.conf.urls import url 
from django.contrib import admin 
from . import helloworld 


urlpatterns = [ 
url(r'\admin/', admin.site.urls), 
url(r'^$', helloworld. index), 


FT o RAT o bm rS 是 为 了 匹配 空 事 ， 也 就 是 形 如 : http://localhost:8000/ ° 4r Rik AY 
web server 已 经 启动 了 ， 那 么 直接 刷新 页 面 就 行 了 。 


现在 觉得 Django 是 不 是 简单 多 了 ， 除 了 创建 一 个 项 目的 操作 ， 然 后 可 能 要 修改 两 个 配置 文 
件 ， 其 它 还 都 简单 吧 。 


4 结论 


Django 本 身 的 确 是 一 种 松散 的 框架 组 合 ， 它 既 复 杂 又 简单 。 复 杂 是 因为 如 果 你 想 使 用 它 的 自 
动 化 的 、 高 级 的 功能 你 需要 学 习 很 多 的 东西 ， 而 且 它 的 教程 一 上 来 就 是 以 这 种 过 于 完整 的 例 
子 进 行 展示 ， 自 然 会 让 你 觉得 很 麻烦 。 不 过 看 了 我 的 讲解 之 后 ， 是 不 是 觉得 还 是 挺 简单 的 。 
那么 我 们 就 先 以 无 数据 库 的 方式 进行 下 去 ， 一 点 点 地 发 气 Django 的 功能 特性 吧 。 


可 


过 头 来 再 细 想 一 想 ， 之 所 以 认为 Karrigell 简单 而 Django 复杂 ， 主 要 在 于 Karrigell 的 教程 
适合 我 们 这 种 由 浅 入 深 ， 循 序 渐 近 的 方式 ， 而 Django 虽然 也 可 以 这 样 ， 但 它 的 教程 却 没有 做 
成 这 样 ， 因 此 让 我 们 茫然 。 当 然 到 最 后 ， 在 我 们 熟练 之 后 我 们 不 再 会 有 这 样 的 感觉 ， 毕 竟 这 
只 是 入 门 的 体验 ， 但 就 是 这 种 体验 可 能 会 吓 走 许多 的 人 呢 。 


Django Step by Step (=>) 


随 着 学 习 ， 我 们 的 例子 也 开始 复杂 了 ， 下 一 步 我 想 实现 一 个 简单 的 web 加 法 器 。 界 面 会 是 这 
样 : 


2 + {3 l=) 5 
很 简单 。 通 过 本 节 的 学 习 我 们 可 以 学 习 到 : 


如 何 处 理 页 面 表格 提交 的 数据 ， 并 且 会 对 URL Dispatch 作 更 进一步 的 解释 。 


2 创建 add.py 文件 


我 们 在 newtest 子 目录 中 创建 一 个 add.py 文件 。( 由 于 我 们 还 没有 涉及 到 Django 的 模型 ， 
此 象 add.py 这 样 的 东西 叫 什 么 呢 ? 还 是 称 其 为 View °- AA django 中 ，View 是 用 来 显 
示 的 ， 它 代替 了 一 般 的 MVC 中 的 Control 的 作用 ， 因 为 Django 中 不 是 MVC 而 是 MTV 
(Model Template View)) 


from django.http import HttpResponse 


text = """<form method="post" action="/add/"> 
<input type="text" name="a" value="%d"> + <input type="text" name="b" value="%d"> 
<input type="submit" value="="> <input type="text" value="%d"> 

</form>""" 


def index(request): 
if 'a' in request.POST: 
a = int(request.POST['a']) 
b = int(request.POST['b']) 


a= 0 
b = 0 
return HttpResponse(text % (a, b, a + b)) 


这 里 只 有 一 个 index 方法 。 所 有 在 view 中 的 方法 第 一 个 参数 都 会 由 Django 传 入 request 对 
象 ， 它 就 是 请 求 数 据 对 象 ， 它 是 由 Django 自动 生成 。 其 中 有 GET 和 POST 属性 ， 分 别 保存 
两 种 不 同 的 提交 方式 的 数据 ， 它 们 都 可 以 象 字 典 一 样 工 作 。 


那么 我 的 想法 就 是 : 


进入 页 面 就 是 上 面 的 效果 ， 页 面 上 有 两 个 输入 文本 框 ， 一 个 提交 按钮 ， 一 个 显示 结果 的 文本 
框 。 在 两 个 输入 文本 框 中 输入 整数 ， 然 后 点 击 提 交 ("=" 号 按钮 )， 将 返回 相同 的 页 面 ， 但 结果 
文本 框 中 将 显示 两 数 相 加 的 和 。 两 个 输入 文本 框 分 别 定 义 为 a 和 b。 


这 里 的 逻辑 就 是 : POST 数据 中 是 否 有 变量 a ， o 表示 是 第 一 次 进入 ， 则 al 
b 初始 为 0， 然后 返回 页 面 。 如 果 有 变量 a， 则 计算 结果 ， 返 回 页 面 。 


这 里 面 有 许多 可 以 细 说 的 东西 ， 那 么 我 把 它们 放 在 后 面 陈述 。 


3 修改 urls.py 


from django.conf.urls import url 
from django.contrib import admin 
from . import helloworld, add 
urlpatterns = [ 

url(r'Aadmin/', admin.site.urls), 


url(r'4$', helloworld.index), 
url(r'add/$', add.index), 


增加 add 的 url 映射 。 
后 动 Server 


5 在 浏览 颈 测 试 
http://localhost:8000/add 


点 击 提交 之 后 ， 你 会 看 到 下 面 这 个 信息 : 


Forbidden (403) 


CSRF verification failed) Request aborted. 


Help 


Reason given for failure: 
CSRF token missing or incorrect. 


In general, this can occur when there is a germine Cross Site Request Forgery, or when Django’s CSRF mechanism has not been used correctly. For 
POST forms, you need to ensure: 


Your browser is accepting cookies. 

The view function passes a request to the template’s render method. 

In the template, there is a {% csrf_token %} template tag inside each POST form that targets an internal URL. 

If you are not using CsrfV¥iewMiddleware, then you must use csrf protect on any views that use the csrf_token template tag, as well 
as those that accept the POST data 

« The form has a valid CSRF token. After logging in in another browser tab or hitting the back button after a login, you may need 
to reload the page with the form, because the token is rotated after a login. 


You re seeing the help section of this page because you have DEBUG = True in your Django settings file. Change that to False, and only the 
initial error message will be displayed. 


You can customize this page using the CSRF_FAILURE_VIEW setting. 








这 是 由 于 Django 默 认 启 动 了 防止 CSRF (Cross-site request forgery : 跨 站 请 求 伪造 ， 是 一 种 
对 网 站 的 恶意 利用 ) 攻击 的 安全 设置 。 本 章 暂 不 讨论 这 方面 的 内 容 ， 我 们 通过 装饰 器 
(decorator) 关闭 这 个 设置 。 


修改 add.py 文 件 : 


from django.http import HttpResponse 
from django.views.decorators.csrf import csrf_exempt 


text = """<form method="post" action="/add/"> 
<input type="text" name="a" value="%d"> + <input type="text" name="b" value="%d"> 
<input type="submit" value="="> <input type="text" value="%d"> 

</FORM> RA 


@csrf_exempt 
def index(request): 
if 'a' in request.POST: 
a = int(request.POST['a']) 
b = int(request.POST['b']) 


a= 0 
b = 0 
return HttpResponse(text % (a, b, a + b)) 


你 会 看 到 和 我 相似 的 界面 ， 然 后 输入 整数 试 一 试 吧 。 


6 th It 


1. Æ form 中 的 method="post"。 你 当然 可 以 使 用 get » 12 Django 的 设计 风格 中 认 
为 ， 使 用 POST 表示 要 对 数据 进行 修改 ， 使 用 GET 则 只 是 获取 ， 这 是 一 个 设计 风格 ， 并 
且 不 仅仅 属于 Django 。 如 果 能 够 养 成 习惯 是 非常 好 的 。 

2. Django 提供 了 URL Dispatch 文档 ， 专 门 讲解 有 关 url 映射 的 东西 。 其 中 有 一 部 分 是 关于 
url 的 正则 表达 式 解 析 的 。 原 本 我 认为 象 Karrigell 中 一 样 ， 定 义 在 form 中 的 变量 会 自动 
映射 为 方法 的 参数 ， 但 是 我 错 了 。 方 法 中 的 参数 是 从 ul 中 通过 正则 表达 式 解析 出 来 的 ， 
或 者 是 在 Url_conf( 即 urls.py 文件 ) 中 指定 的 。 因 此 它 与 Karrigell 一 点 也 不 一 样 。 因 此 ， 
如 果 你 想 从 POST 或 GET 数据 中 得 到 值 ， 那么 象 我 一 样 去 做 好 了 。 使 用 request.POST 
或 request.GET 或 还 有 一 个 可 以 “ 统 吃 "的 方法 request.REQUEST ， 它 们 是 一 个 字典 数 
据 ， 使 用 起 来 也 算 方便 。 


从 这 里 我 更 想 了 解 方法 中 参数 的 使 用 ， 当 然 这 个 例子 并 没有 ， 有 机 会 再 使 用 吧 。 关 于 正则 表 
达 式 解析 参数 在 blog 和 rss 中 用 得 是 非常 多 的 


Django Step by Step (=) 


1 引言 


本 教程 只 想 从 浅 到 深 地 将 大 家 带 入 到 Django 的 世界 ， 因 此 都 是 以 简单 的 例子 出 发 ， 而 且 这 些 
例子 都 是 为 了 说 明 问题 ， 本 身 并 没有 什么 实际 的 意义 。 因 此 许多 高 级 话题 都 无 法 涉及 ， 需 要 
大 家 自行 看 文档 ， 做 试验 。 


从 上 一 例 我 们 看 到 ， 表 格 的 生成 是 直接 在 index() 函数 中 返回 的 HTML 代码 ， 这 种 混合 方式 对 
于 大 型 开发 非常 不 好 ， 下 面 我 们 就 学 习 模 板 的 使 用 。 Django 自 带 有 模板 系统 ， 但 你 可 以 不 使 

用 它 ， 只 要 在 return 前 使 用 自己 喜欢 的 模板 系统 进行 处 理 ， 然 后 返回 即 可 。 但 Django 自 带 的 
eee ， 我 不 做 过 多 的 说 明 。 我 只 是 想 使 用 它 


现在 我 的 问题 就 是 : 
我 有 一 个 通讯 录 数 据 ， 我 想 使 用 一 个 表格 来 显示 。 


为 了 方便 ， 我 们 不 需要 使 用 数据 库 ， 因 此 我 把 它 存 在 view 文件 中 。 


2 创建 list.py 


from django.shortcuts import render_to_response 
address = [ 


{'name':' 张 三 '，'address':' 地 址 一 '}， 
{'name':' 李 四 '，'address':' 地 址 二 '} 


def index(request): 
return render_to_response('list.html', {'address': address}) 


这 里 使 用 了 一 个 新 方法 是 render_to_response ， 它 可 以 直接 调用 模板 并 返回 生成 好 的 文本 ， 
直接 返回 它 即 可 。 它 接收 两 个 参数 ， 第 一 个 是 模板 的 名 字 。 


第 二 个 参数 是 一 个 字典 ， 这 里 只 有 一 个 Key > SER address ， 它 的 值 是 一 个 字典 的 列表 。 
只 要 注意 模板 所 接收 的 就 是 这 样 的 字典 和 包含 字典 的 列表 就 行 了 。 


3 在 newtest 中 创建 templates 目录 


用 来 存放 模板 文件 


4 修改 settings.py 
修改 INSTALLED_APPS 的 内 容 ， 增 加 'newtest'，， 最 后 的 设置 为 : 


INSTALLED_APPS = [ 
"django.contrib.admin', 
"django.contrib.auth', 
"django.contrib.contenttypes', 
"django.contrib.sessions', 
"django.contrib.messages', 
"django.contrib.staticfiles', 
"newtest', 


Django 会 自动 搜索 newtest/templates 目 录 下 的 模板 文件 。 


5 创建 templates/list.html 


<h2> 通 讯 录 </h2> 
<table border="1"> 
<tr><th> 姓 名 </th><th> 地 址 </th></tr> 
{% for user in address %} 
<tr> 
<td>{{ user.name }}</td> 
<td>{{ user.address }}</td> 
</tr> 
{% endfor %} 
</table> 


很 简单 ， 就 是 生成 了 一 个 两 列 的 表格 。 在 Django 模板 中 (93 表示 引用 一 个 变量 ， {ow%} 
表示 代码 调用 。 在 变量 引用 中 ，Dijango 还 支持 对 变量 属性 的 访问 ， 同 时 它 还 有 一 定 的 策略 ， 
详细 的 建议 查看 The Django template language 文档 。 这 里 我 也 使 用 了 汉字 ， 因 此 它 也 需要 
使 用 utf-8 编码 。 


这 里 使 用 for..in 的 模板 Tag 处 理 。 因 此 address 需要 是 一 个 集合 。 在 我 们 的 View 代码 中 ， 
address 为 一 个 list 值 。 每 个 list 又 是 一 个 字典 。 因 此 cf user.name }} 和 {{ user.address 
p 就 是 将 这 个 字典 中 的 元 素 取 出 来 。 


6 修改 urls.py 


from django.conf.urls import url 
from django.contrib import admin 
from . import helloworld, add, list 


urlpatterns = [ 
url(r'\admin/', admin.site.urls), 
url(r'4$', helloworld.index), 
url(r'Aadd/$', add.index), 
url(r'Alist/$', list.index), 


增加 了 list 的 url 映射 。 


7 È) server 
效果 如 这 样 : 
通讯 录 
WER, | HE 
i= Shak 
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Django Step by Step (四 ) 


1 引言 
经 过 前 几 节 的 学 习 ， 我 想 大 家 应 该 比较 熟悉 Django 的 大 致 开发 流程 : 


e 增加 view 方法 
o 增加 模板 
e 修改 urls.py 


就 是 这 样 。 剩 下 的 就 是 控 气 Django 提供 的 其 它 的 能 力 。 在 我 们 还 没有 进入 模型 (model) 之 前 
还 是 再 看 一 看 外 围 的 东西 ， 再 更 进一步 体验 Django 吧 。 


# Django 中 我 看 到 了 一 个 生成 csv 格式 的 文档 (Outputting CSV dynamically)， 非 常 好 ， 它 没 
有 数据 库 ， 正 好 用 来 做 演示 。 


更 进一步 ， 现 在 我 的 需求 就 是 提供 excel 格式 文件 的 下 载 。 


我 们 会 在 原来 list( 表 格 ) 例子 基础 上 进行 演示 ， 步 骤 就 是 上 面 的 流程 。 


2 修改 templates/list.htmi 
在 文件 最 后 增加 : 


<p><a href="/xls/address/">Excel 格 式 下 载 </a></p> 


它 将 显示 为 一 个 链接 ， 它 所 指向 的 链接 将 用 来 生成 Excel 文件 。 


3 在 newtest 下 增加 xls_test.py 


from django.http import HttpResponse 
from django.template import loader, Context 


address = [ 
(' 张 三 '，' 地 址 一 ' )， 
Ce Ce) 
] 


def output(request, filename): 
response = HttpResponse(content_type='application/ms-excel' ) 
response['Content-Disposition'] = ‘attachment; filename=%s.xls' % filename 


t = loader.get_template('xls.html') 
c = Context({ 
"data': address, 


}) 


response.write(t.render(c)) 
return response 


这 里 使 用 的 东西 多 了 一 些 。 这 里 没有 render_to_response 了 ， 而 是 演示 了 一 个 完整 的 从 头 进 
行 模板 解析 的 处 理 过 程 。 为 什么 需要 这 样 ， 因 为 我 们 需要 修改 response 对 象 的 值 ， 而 

render_to_response 封装 了 它 使 得 我 们 无 法 修改 。 从 这 里 我 们 也 可 以 看 到 ， 在 调用 一 个 方法 

时 ，Dijango 会 传 入 一 个 request 对 象 ， 在 返回 时 ， 你 需要 将 内 容 写 入 response ， 必 要 时 

修改 它 的 某 些 属性 。 更 详细 的 建议 你 参考 django 所 带 的 request_response 文档 ， 里 面 详细 
首 述 了 两 个 对 象 的 内 容 ， 并 且 还 可 以 在 交互 环境 下 进行 测试 ， 学 习 非 常 方便 。 


这 里 address 不 再 是 字典 的 列表 ， 而 是 tuple 的 列表 。 让 人 高 兴 的 是 ，Dijango 的 模板 除了 
可 以 处 理 字典 ， 还 可 以 处 理 序 列 ， 而 且 可 以 处 理 序列 中 的 元 素 。 一 会 在 模板 定义 中 我 们 会 看 
到 o 


这 里 output() 是 我 们 希望 Django 调用 的 方法 ， 不 再 是 index) 了 。( 不 能 老 是 一 样 的 
呀 。) 而 且 它 与 前 面 的 inex) 不 同 ， 它 带 了 一 个 参数 。 这 里 主要 是 想 演 示 ur 的 参数 解析 。 
因此 你 要 注意 ， 这 个 参数 一 定 是 放 在 ul 上 的 。 它 表示 输出 文件 名 。 


response = HttpResponse(mimetype='application/ms-excel') 
response['Content-Disposition'] = ‘attachment; filename=%s.xls' % filename 


这 两 行 是 用 来 处 理 输出 类 型 和 附件 的 ， 以 前 我 也 没有 用 过 ， 这 回 也 学 到 了 。 它 表明 返回 的 是 
一 个 Excel 格 式 的 文件 。 


= loader.get_template('xls.html') 
c={ 


'data': address, 


ct 
1 


} 


response.write(t.render(c)) 


这 几 行 就 是 最 原始 的 模板 使 用 方法 。 先 通过 loader 来 找到 需要 的 模板 ， 然 后 生成 一 个 
template 对 象 ， 再 生成 一 个 context 对 象 ， 它 就 是 一 个 字典 集 。 然 后 t.render(c) 这 个 用 
来 对 模板 和 提供 的 变量 进行 合并 处 理 á 生成 最 终 的 结果 R 最 后 调用 response.write() 将 内 容 
写 入 。 


4 增加 templates/xls.html 


<!DOCTYPE html> 
<html lang="zh-cn"> 
<head> 
<meta charset="utf-8"> 
</head> 
<body> 
<table> 
{% for row in data %} 
= Cre 
<td>{{ row.0|addslashes}}</td> 
<td>{{ row.1]addslashes}}</td> 
</tr> 
{% endfor %} 
</body> 
</html> 


使 用 了 一 个 for 循环 。 这 里 data FEMA context data 相对 应 。 因 为 data 是 一 个 
列表 ， 它 的 每 行 是 一 个 tuple ， 因 此 row.o, row.1 就 是 取 tuple 的 第 一 个 和 第 二 个 元 
素 。| 是 一 个 过 滤 符 ， 它 表示 将 前 一 个 的 处 理 结果 作为 输入 传 入 下 一 个 处 理 。 因 此 Django 
的 模板 很 强大 ， 使 用 起 来 也 非常 直观 和 方便 。 addslashes 是 Django 模板 内 置 的 过 滤 Tag ， 
它 用 来 将 结果 中 的 特殊 字符 加 上 反 斜 线 。 


同时 我 们 注意 到 ， 每 个 (93 前 后 都 有 一 个 双 引 号 ， 这 样 就 保证 每 个 字符 串 使 用 双 引 号 引起 
来 。 然 后 在 第 一 个 与 第 二 个 元 素 之 间 还 使 用 了 各 号 分 隔 。 最 后 endfor 在 下 一 行 ， 表 示 上 面 
每 行 模板 后 有 一 个 回 车 。 

Django 还 允许 你 自 定义 Tag ， 在 The Django template language: For Python programmers 
文档 中 有 描述 ， 其 实 是 很 简单 的 。 


5 修改 urls.py 


from django.conf.urls import url 
from django.contrib import admin 
from . import helloworld, add, list, xls_test 


urlpatterns = [ 
url(r'Aadmin/', admin.site.urls), 
url(r'A$', helloworld.index), 
url(r'Aadd/$', add.index), 
url(r'Alist/$', list.index), 
url(r'Axls/(?P<filename>\wt+)/$', xls_test.output), 


增加 了 xls 的 url 映射 。 


上 面 的 正则 表达 式 有 些 复杂 了 ， 因为 有 参数 的 处 理 在 里 面 ° (?P<filename>\w+) 这 是 一 个 将 
解析 结果 起 名 为 ”filename 的 正则 表达 式 ， 它 完全 符合 Python 正则 表达 式 的 用 法 。 在 最 新 的 
Django 中 ， 还 可 以 简化 一 下 : (\w+) 。 但 这 样 需 要 你 的 参数 是 按 顺序 传 入 的 ， 在 一 个 方法 
有 多 个 参数 时 一 定 要 注意 顺序 。 


还 记得 吗 ? 我 们 的 链接 是 写成 /xls/address/ ， 因 此 上 面 实际 上 会 变 成 对 


xls_test.output(filename='address' ) 的 调用 。 


6 È a) server 


看 一 下 结果 吧 。 点 击 链接 ， 浏 览 器 会 提示 你 保存 文件 的 。 


很 简单 吧 。 但 这 里 面 的 内 容 其 实 也 不 少 ， 而 且 许 多 地 方 都 有 很 大 的 扩展 空间 。 


Django Step by Step (2) 


tae 


其 实 本 教程 以 展示 基本 概念 为 已 任 ， 对 于 一 些 高 级 的 话题 我 也 在 不 停 地 学 习 中 ， 和 希望 能 有 所 
展示 。 让 我 们 一 起 学 习 吧 。 


在 了 解 了 基本 的 Django 开发 的 过 程 及 Django 的 一 些 基 本 特性 之 后 ， 越 来 越 多 的 东西 在 等 着 
我 们 。 现 在 我 们 就 学 习 一 下 session 吧 。 session 可 以 翻译 为 “会话 "， 做 过 web 的 可 能 都 知 
道 。 它 就 是 为 了 实现 页 面 间 的 数据 交换 而 产生 的 东西 ， 一 般 有 一 个 Session id ， 它 会 保存 在 
浏览 器 的 cookie 中 ， 因 此 如 果 你 的 浏览 器 禁止 了 cookie ， 下 面 的 试验 是 做 不 了 的 。 


在 Django 中 的 session 也 非常 简单 ， 它 就 存在 于 request 对 象 的 session 属性 中 。 你 可 以 
把 它 看 成 一 个 字典 就 可 以 了 。 


下 面 我 们 做 一 个 非常 简单 的 功能 : 首先 当 用 户 进入 某 个 页 面 ， 这 个 页 面 会 显示 一 个 登录 页 
面 ， 上 面 有 一 个 文本 框 用 来 输入 用 户 名 ， 还 有 一 个 提交 按钮 用 来 提交 数据 。 当 用 户 输入 用 户 
名 ， 然 后 点 提交 ， 则 显示 显示 用 户 已 经 登录 ， 并 且 打 印 出 用 户 的 姓名 来 ， 同 时 还 提供 一 个 " 注 
销 "按钮 。 然 后 如 果 用 户 再 次 进入 这 个 页 面 ， 则 显示 同 登 录 成 功 后 的 页 面 。 如 果 点 击 注销 则 重 
新 进入 未 登录 的 页 面 


2 在 newtest 下 创建 login.py 


from django.http import HttpResponseRedirect 
from django.shortcuts import render_to_response 
from django.views.decorators.csrf import csrf_exempt 


@csrf_exempt 
def login(request): 
username = request.POST.get('username', None) 
if username: 
request.session['username'] = username 
username = request.session.get('username', None) 
if username: 
return render_to_response('login.html', {'username':username}) 
elise: 
return render_to_response('login.htm1' ) 


@csrf_exempt 
def logout(request): 
Erny: 
del request.session['username'] 
except KeyError: 
pass 
return HttpResponseRedirect("/login/") 


有 些 复杂 了 吗 ? 没关系 ， 让 我 解释 一 下 。 这 里 有 两 个 方法 : login() 和 logout() ° 
login() 用 来 提供 初始 页 面 、 处 理 提供 数据 和 判断 用 户 是 否 登 录 。 而 logout() 只 是 用 来 从 
session 中 删除 用 户 名 ， 同 时 将 页 面 重 定向 到 login 画面 。 这 里 我 仍然 使 用 了 模板 ， 并 且 根 据 
传 入 不 同 的 字典 来 控制 模板 的 生成 。 是 的 ， 因 为 Django 的 模块 支持 条 件 判断 ， 所 以 可 以 做 
到 。 


在 login) 中 的 判断 逻辑 是 : 


e ŽI POST P username (这 样 username 需要 由 模板 的 form 来 提供 )， 如 果 存 在 则 加 
入 到 session 中 去 。 加 入 session 很 简单 ， 就 是 一 个 字典 的 Key 赋值 。 

e 然后 再 从 session 中 取 username ， 有 两 种 可 能 : 一 种 是 上 一 步 实现 的 。 还 有 一 种 可 能 
是 直接 从 以 前 的 session 中 取出 来 的 ， 它 不 是 新 产生 的 。 而 这 里 并 没有 细 分 这 两 种 情 
况 。 因 此 这 个 判断 其 实 对 应 两 种 页 面 请 求 的 处 理 : 一 种 是 提交 了 用 户 姓名 ， 而 另 一 种 则 
是 处 理 完 用 户 提交 姓名 之 后 ， 用 户 再 次 进入 的 情况 。 而 用 户 再 次 进入 时 ， 由 于 我 们 在 前 
面 已 经 将 他 的 名 字 保存 在 session 里面 了 ， 因 此 可 以 直接 取出 来 。 如 果 session 中 存在 ， 
则 表示 用 户 已 经 登录 过 ， 则 输出 login.html 模板 ， 同 时 传 入 了 username 字典 值 。 而 
如 果 session 中 不 存在 ， 说 明 用 户 从 来 没有 登录 过 ， 则 输出 login.html 模板 ， 这 次 不 带 
值 。 


因此 对 于 同一 个 login.htm 模板 传 入 的 不 同 值 ， 后 面 我 们 会 看 到 模板 是 如 何 区 分 的 。 


在 logout() 中 很 简单 。 先 试 着 删除 session ， 然 后 重 定向 页 面 到 login 页 面 。 这 里 使 用 了 
HttpResponseRedirect 方法 ， 它 是 从 以 前 我 们 看 到 的 HttpResponse 派生 来 的 子 类 m 更 多 的 
派生 子 类 和 关于 response 的 内 容 要 参考 Request and response objects 文档 。 


3 创建 templates/login.html 


{% if not username %} 

<form method="post" action="/login/"> 
用 户 名 : <input type="text" name="username" value=""><br/> 
<input type="submit" value="% "> 

</form> 

{% else %} 

你 已 经 登录 了 | {{ username }}<br/> 

<form method="post" action="/logout/"> 
<input type="submit" value=" 注 销 "> 

</form> 

{% endif %} 


整个 是 一 个 if 语句 。 在 Django 模板 中 的 if TAR Python 一 样 使 用 ， 如 使 用 not ， 
and , or ° 象 if not username 表示 什么 呢 ? 它 表 示 如 果 USername 不 存在 ? 或 为 空 ， 或 
是 假 值 等 等 。 而 此 时 我 们 利用 了 username 不 存在 这 种 判断 。 


上 面 的 逻辑 表示 ， 如 果 username 不 存在 ， 则 显示 一 个 表单 ， 显 示 用 户 名 输入 文本 框 。 如 果 
存在 ， 则 显示 已 经 登录 信息 ， 同 时 显示 用 户 名 和 注销 按钮 。 而 这 个 注销 铵 钮 对 应 于 logout() 
方法 。 


4 修改 urls.py 


from django.conf.urls import url 
from django.contrib import admin 
from . import helloworld, add, list, xls_test, login 


urlpatterns = [ 
url(r'Aadmin/', admin.site.urls), 
url(r'4$', helloworld.index), 
url(r'^add/$', add.index), 
url(r'Alist/$', list.index), 
url(r'Axls/(?P<filename>\w+)/$', xls_test.output), 
url(r'Alogin/$', login.login), 
url(r'Alogout/$', login.logout), 


增加 了 login 和 logout 两 个 url 映 射 。 


oe PETE 
5 后 动 server 运行 

但 我 要 说 ， 你 一 定 会 报错 。 而 且 我 的 也 在 报错 。 为 什么 ， 因 为 从 这 一 刻 起 ， 我 们 就 要 进入 有 
数据 库 的 环境 了 。 因 为 在 django 中 session 是 存放 在 数据 库 中 的 。 所 以 在 这 里 要 进行 数据 库 
的 初始 化 了 。 

6 查看 settings.py 

我 们 在 创建 newtest 工 程 的 时 候 ，Dijango 已 经 为 我 们 默认 生成 了 数据 库 处 理 的 配置 : 


DATABASES = { 
"default': { 
"ENGINE': 'django.db.backends.sqlite3', 
"NAME': os.path.join(BASE_DIR, 'db.sqlite3'), 


这 里 使 用 的 是 sqlite3。 在 使 用 数据 库 时 ， 你 同时 需要 自己 去 安装 相应 的 数据 库 处 理 模块 。 


7 初始 化 数据 库 
配置 不 需要 做 什么 修改 ， 下 一 步 我 们 进行 数据 库 的 初始 化 工作 ， 包 括 建 库 、 建 表 等 


python manage.py migrate 


8 È a) server 


这 次 再 进入 试 吧 
(http://localhost:8000/login/) 


从 此 我 们 要 进入 数据 库 的 世界 了 ， 当 然 目前 还 没有 用 到 ， 而 Django 提供 的 许多 自动 化 的 高 级 
功能 都 是 需要 数据 库 支持 的 。 
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以 后 的 例子 可 能 会 越 来 越 复杂 ， 没 办 法 因为 我 们 用 的 东西 越 来 越 复杂 ， 同 时 我 们 的 能 力也 在 
增长 。 
下 面 我 们 按照 TurboGears 的 Wiki in 20 Minutes 的 例子 仿照 一 个 ， 我 们 要 用 Django 来 做 
wiki。 我 不 会 按 TurboGears 的 操作 去 做 ， 只 是 实现 一 个 我 认为 的 最 简单 的 wiki © 
现在 我 的 要 求 是 : 
做 一 个 简单 的 wiki， 要 可 以 修改 当前 页 面 ， 即 在 页 面 下 面 提供 一 个 编辑 的 按钮 。 然 后 还 要 
识别 页 面 中 的 两 个 开头 大 写 的 单词 为 页 面 切换 点 ， 可 以 进入 一 个 已 经 生成 好 的 页 面 ， 或 
提示 创建 一 个 新 页 面 。 


下 面 我 们 将 开始 创建 Django 中 的 app T ° 


先 说 一 下 。 如 果 你 看 过 官方 版 的 教程 ， 它 就 是 讲述 了 一 个 Poll 的 app 的 生成 过 程 。 那 么 一 个 
app 就 是 一 个 功能 的 集合 ， 它 有 自己 的 model > view 和 相应 的 模板 ， 还 可 以 带 自 己 的 urls.py 
。 那 么 它 也 是 一 个 独立 的 目录 ， 这 样 一 个 app 就 可 以 独立 地 进行 安装 ， 你 可 以 把 它 安装 到 其 
它 的 Django 服务 器 中 去 。 因 此 采用 app 的 组 织 形式 非常 有 意义 。 而 且 adango-admin.py 也 
提供 了 一 个 针对 app 的 命令 ， 一 会 我 们 就 会 看 到 。 而 且 Django 提供 一 些 自动 功能 也 完全 是 
针对 于 app 这 种 结构 的 。Model, Template, View 就 合成 了 MTV 这 几 个 字母 。 Model 是 用 来 
针对 数据 库 ， 同 时 它 可 以 用 来 自动 生成 管理 界面 ，View 在 前 面 我 们 一 直 都 用 它 ， 用 来 处 理 请 
求 和 响应 的 相当 于 MVC 框 架 中 的 Controller 的 作用 ，Template 用 来 生成 界面 。 


2 创建 wiki app 


python manage.py startapp wiki 


这 样 在 wiki 子 目录 下 有 以 下 文件 : 
e init.py 表示 wiki 目录 是 一 个 包 。 
e views.py 用 来 放 它 的 view 的 代码 。 
e models.py 用 来 放 model 代码 。 


e apps.py 用 来 放 配 置 代码 


e admin.py 用 来 配置 当前 的 wiki 如 何 使 用 Django Admin 功 能 
e tests.py 用 来 放 测 试 代码 


e migrations 目 录 用 来 放 每 一 次 数据 库 变 化 后 需要 对 数据 库 做 的 变化 


3 编辑 wiki/models.py 


from django.db import models 


# Creat 





e your models here. 








ki(models.Model): 
pagename = models.CharField(max_length=20, unique=True) 
content = models.TextField() 





class Wi 


每 个 model 其 实在 Django 中 就 是 一 个 表 ， 你 将 用 它 来 保存 数据 。 在 实际 的 应 用 中 ， 一 般 都 
要 与 数据 库 打 交道 ， 如 果 你 不 想 用 数据 库 ， 那 么 原因 可 能 就 是 操作 数据 库 麻 烦 ， 创 建 数 据 库 
环境 也 麻烦 。 但 通过 Django 的 model 处 理 ， 它 是 一 种 ORM (Object Relation Mapping, 对 象 
与 关系 的 映射 )， 可 以 屏蔽 掉 底 层 数 据 库 的 细节 ， 同 时 提供 以 对 象 的 形式 来 处 理 数 据 。 非 常 方 
便 。 而 且 Django 的 model 层 支 持 多 种 数据 库 ， 如 果 你 改变 数据 库 也 不 是 什么 问题 ， 这 也 为 
以 后 的 数据 库 迁 移 带 来 好 处 。 总 之 ， 好 处 多 多 ， 大 家 多 多 体会 吧 。 


Wiki 是 model 的 名 字 ， 它 需要 从 models.Model 派生 而 来 。 它 定义 了 两 个 字段 ， 一 个 是 字段 
是 pagename ， 用 来 保存 wiki 页 面 的 名 字 ， 它 有 两 个 参数 ， 一 个 是 最 大 长 度 (不 过 从 这 点 上 
不 如 SQLAIchemy 方便 , SQLAIchemy 并 不 需要 长 度 ， 它 会 根据 有 无 长 度 自动 转 为 TEXT 类 
型 )， 目 前 CharField 需要 这 个 参数 ; 另 一 个 是 unique 表示 这 个 字段 不 能 有 重复 值 。 还 有 一 个 
字段 是 content ， 用 来 保存 wiki 页 面 的 内 容 ， 它 是 一 个 TextField 类 型 ， 它 不 需要 最 大 长 度 。 


现在 不 太 了 解 model 没有 关系 ， 关 键 是 看 整个 生成 过 程 。 


一 旦 你 定义 好 了 model ， 在 运行 时 ，Dijango 会 自动 地 为 这 个 model 增加 许多 数据 操作 的 方 
法 。 关 于 model 和 数据 库 操作 API 的 详细 内 容 参 见 Model reference 和 Database API 
reference 的 文档 。 


4 修改 settings.py, 安装 app 


虽然 我 们 的 其 它 工作 没有 做 完 ， 但 我 还 是 想 先 安装 一 下 app 吧 。 每 个 一 app 都 需要 安装 一 
下 。 安 装 一 般 有 两 步 : 


4.1 修改 settings.py 


INSTALLED_APPS = [ 


"django. 
"django. 
"django. 
"django. 
"django. 
"django. 


contrib 


contrib. 
contrib. 
contrib. 


contrib 


contrib. 


'newtest', 


.admin', 


auth', 
contenttypes', 
sessions', 


.messages', 


staticfiles', 


"wiki.apps.WikiConfig', 


这 个 在 文件 的 最 后 ，django 开 头 的 是 缺 省 定义 的 。 给 


了 以 后 方便 地 导入 所 必须 的 。 因 为 我 们 的 目录 都 是 包 


的 。 


4.2 执行 (在 newtest 目 录 下 ) 


python manage.py makemigrations 


python manage.py migrate 


果 没 有 报错 就 是 成 功 了 。 这 一 
ee 样 创 建 出 来 的 。 


出 指定 Wiki 包 的 引用 名 来 。 这 一 步 是 为 
的 形式 ， 因 此 这 里 就 是 与 目录 相对 应 


步 Django 将 根据 model 的 信息 在 数据 库 中 创建 相应 的 表 。 


5 在 命令 行 下 加 入 首页 (FrontPage) 


我 们 假设 首页 的 名 字 为 FrontPage ， 并 且 我 们 将 在 命令 


的 使 用 


进入 newtest 目录 ， 然 后 : 


python manage.py shell 


进入 python 


{FF iE + LAMBRA F ES 


>>> from wiki.models import Wiki 

>>> page = Wiki(pagename='FrontPage', content='Welcome to Easy Wiki') 
>>> page.save() 

>>> Wiki.objects.all() 

[<wiki object>] 

>>> p = Wiki.objects.all()[0] 

>>> p.pagename 

"FrontPage' 

>>> p.content 

"Welcome to Easy Wiki' 


在 Django 中 ， 对 于 数据 库 的 记录 有 两 种 操纵 方式 ， 一 种 是 集合 方式 ， 一 种 是 对 象 方式 。 集 合 
方式 相当 于 表 级 操作 ， 可 以 使 用 model.objects 来 处 理 。 objects 对 象 有 一 些 集合 方式 的 操 
作 ， 如 all() 会 返回 全 部 记录 ，filter() 会 根据 条 件 返回 部 分 记录 。 而 象 插入 新 记录 则 需要 使 用 
记录 方式 来 操作 ， 些 时 要 直接 使 用 model 类 。 


6 修改 wiki/views.py 


from .models import Wiki 

from django.template import loader, Context 

from django.http import HttpResponse, HttpResponseRedirect 
from django.shortcuts import render_to_response 

from django.views.decorators.csrf import csrf_exempt 


def index(request, pagename=""): 
PRERA H’ HR OA CFR EE g 
if pagename: 
# 查 找 是 否 已 经 存在 页 面 
# pages = Wiki.objects.get_list(pagename__exact=pagename) 
pages = Wiki.objects. filter (pagename=pagename) 
if pages: 
# 存 在 则 调用 页 面 模板 进行 显示 
return process('wiki/page.html', pages[0]) 
else: 
# 不 存在 则 进入 编辑 画面 


return render_to_response('wiki/edit.html', {'pagename':pagename}) 


else: 
# page = Wiki.objects.get_object(pagename__exact='FrontPage' ) 
page = Wiki.objects.get(pagename='FrontPage' ) 
return process('wiki/page.html', page) 


@csrf_exempt 
def edit(request, pagename): 
"0" "显示 编辑 存在 页 面 "0 
# page = Wiki.objects.get_object(pagename__exact=pagename) 
page = Wiki.objects.get(pagename=pagename ) 
return render_to_response('wiki/edit.html', {'pagename':pagename, 'content':page.c 


ontent}) 


@csrf_exempt 

def save(request, paganama), 
"mW 保存 页 面 内 容 ， 老 页 面 进行 内 容 蔡 换 ， 新 页 面 生成 新 记录 """ 
content = request.POST['content'] 


# pages = Wiki.objects.get_list(pagename__exact=pagename) 
pages = Wiki.objects. filter (pagename=pagename ) 
if pages: 


pages[9].content = content 
pages[0].save() 
else: 
page = Wiki(pagename=pagename, content=content) 
page. save() 
return HttpResponseRedirect("/%s" % pagename) 


import re 


r = re.compile(r'\b(([A-Z]+[a-z]+){2,})\b') 
def process(template, page): 
"Wm 处 理 页 面 链 接 ， 并 且 将 回 车 符 转 为 <br>""" 
t = loader.get template(template) 
content = r.sub(r'<a href="/\1">\1</a>', page.content) 
content = re.sub(r'[\n\r]+', '<br>', content) 
= {'pagename':page.pagename, 'content':content} 
return HttpResponse(t.render(c)) 


代码 有 些 长 ， 有些 地 方 已 经 有 说 明和 注释 了 。 简 单 说 一 下 


e index() 用 来 显示 一 个 Wiki 页 面 。 它 需要 一 个 参数 就 是 页 面 的 名 称 。 如 果 在 数据 库 中 找 
得 到 ， 则 调用 process() 方法 ( process() 方法 是 一 个 自 定 义 方法 ， 主 要 用 来 对 页 面 的 
文本 进行 处 理 ， 比 如 查找 是 否 有 满足 wiki 命名 规则 的 单词 ， 如 果 有 则 替换 成 链接 。 再 有 
Mae 7 <br> )。 如 果 没 有 找到 ， 则 直接 调用 编辑 模板 显示 一 个 编程 页 面 。 当 
然 ， 这 个 页 面 的 内 容 是 空 的 。 只 是 它 的 页 面 名 字 就 是 pagename 。 如 果 pagename A 
空 ， 则 进入 FrontPage 页 面 。 Wiki.objects SHA filter() 方法 和 get() 方法 ， 
一 个 返回 一 个 结果 集 ， 一 个 返回 指定 的 对 象 。 这 里 为 什么 使 用 filter() 呢 ， 因 为 一 旦 
指定 文件 不 存在 ， 它 并 不 是 返回 一 个 None 对 象 ， 而 是 抛 出 异常 ， 而 我 没有 使 用 异常 的 
处 理 方式 。 通 过 e 如 果 存 在 则 结果 中 应 有 一 个 元 素 ， 如 果 不 存在 则 应 该 是 一 个 
[] 。 这 样 就 知道 是 否 有 返回 了 。 


Note 


filter() 中 使 用 的 参数 与 一 般 的 db-api 是 一 样 的 ， 但 如 果 是 比较 相等 ， 可 以 为 : 
pagename exact=pagename 也 可 以 简化 为 pagename=pagename 。 


Note 


E Django 中 ， 一 些 字段 的 比较 操作 比较 特殊 ， 它 是 在 字段 名 后 加 ”然后 是 比较 条 件 。 
这 样 看 上 去 就 是 一 个 字符 串 。 具 体 的 参见 The Database API ° 


Note 
回 车 转换 的 工作 其 实 可 以 在 模板 中 使 用 filter 来 完成 。 


© 在 上 一 章 我 们 将 所 有 的 模板 都 放 在 了 newtest/templates 目录 下 ， 从 本 章 开 始 ， 为 了 区 分 
方便 ， 我 们 会 针对 每 一 个 app 创 建 templates/app 的 子 目 录 ， 将 模板 文件 (edit.html) 放 在 
app 目 录 下 统一 管理 。 由 于 Django 针 对 TEMPLATES 的 默认 的 设置 有 'APP_DIRS': True ， 
会 自动 到 每 一 个 app 的 templates 目录 下 寻找 模板 文件 。 


因为 我 们 在 设计 model 时 已 经 设置 了 pagename 必须 是 唯一 的 ， 因 此 一 旦 filter() 有 返回 值 ， 
那 它 只 能 有 一 个 元 素 ， 而 pages[0] 就 是 我 们 想 要 的 对 象 。 


e page = wikis.get(pagename='FrontPage’') 


是 表示 取出 pagename 4 FrontPage 的 页 面 。 你 可 能 要 说 ， 为 什么 没有 异常 保护 ， 是 
的 ， 这 也 就 是 为 什么 我 们 要 在 前 面 先 要 插 条 记录 在 里 面 的 原因 。 这 样 就 不 会 出 错 了 。 再 
加 上 我 要 做 的 wiki 不 提供 删除 功能 ， 因 此 不 用 担心 会 出 现 异 常 。 


edit() 用 来 显示 一 个 编辑 页 面 ， 它 直接 取出 一 个 页 面 对 象 ， 然 后 调用 wiki/edit.html 模 
板 进行 显示 。 也 许 你 还 是 要 问 ， 为 什么 不 考虑 异常 ， 因 为 这 里 不 会 出 现 。 为 什么 ? 因为 
edit() 只 用 在 已 经 存在 的 页 面 上 ， 它 将 用 于 存在 页 面 的 修改 。 而 对 于 不 存在 的 页 面 是 在 

index() 中 直接 调用 模板 来 处 理 ， 并 没有 直接 使 用 这 个 edit() 来 处 理 。 也 许 你 认为 这 样 可 
能 不 好 ， 但 由 于 在 edit() 要 重新 检索 数据 库 ， 而 在 index() 已 经 检索 过 一 次 了 ， 没 有 必要 
再 次 检索 ， 因 此 象 我 这 样 处 理 也 没什么 不 好 ， 效 率 可 能 要 高 一 些 。 当 然 这 只 是 个 人 意 

H o 


save() 用 来 在 编辑 页 面 时 用 来 保存 内 容 的 。 它 先 检 查 页 面 是 否 在 数据 库 中 存在 ， 如 果 不 
存在 则 创建 一 个 新 的 对 象 ， 并 且 保 存 。 注 意 ， 在 Django 中 ， 对 对 象 处 理 之 后 只 有 调用 它 
的 save() 方法 才 可 以 申 正 保存 到 数据 库 中 去 。 如 果 页 面 已 经 存在 ， 则 更 新 页 面 的 内 容 。 
处 理 之 后 再 重 定向 到 index) 去 显示 这 个 页 面 。 


7 在 wiki 中 创建 templates 子 目 录 


8 编辑 wiki/templates/wiki/page.html 


<h2>{{ pagename }}</h2> 

<p>{{ content }}</p> 

<hr/> 

<p> 

<form method="POST" action="/wiki/{{ pagename }}/edit/"> 
<input type="submit" value=" %i 4"> 

</form></p> 


它 用 来 显示 页 面 ， 同 时 提供 一 个 “编辑 ”按钮 。 当 点 击 这 个 按钮 时 将 调用 view 中 的 edit() 7 
法 。 


9 编辑 wiki/templates/wiki/edit.html 


<h2> 编 辑 : {{ pagename }}</h2> 

<form method="POST" action="/wiki/{{pagename}}/save/"> 

<textarea name="content" rows="10" cols="50">{{ content }}</textarea><br/> 
<input type="submit" Value=" 保 存 "> 

</form> 


它 用 来 显示 一 个 编辑 页 面 ， 同 时 提供 "保存 按钮。 点击 了 保存 按钮 之 后 ， 会 调用 view 中 的 
save() 方法 。 


10 修改 urls.py 


from django.conf.urls import include, url 
from django.contrib import admin 
from . import helloworld, add, list, xls_test, login 


urlpatterns = [ 
url(r'Aadmin/', admin.site.urls), 
url(r'4$', helloworld.index), 
url(r'^add/$', add.index), 
url(r'Alist/$', list.index), 
url(r'Axls/(?P<filename>\w+)/$', xls_test.output), 
url(r'Alogin/$', login.login), 
url(r'Alogout/$', login.logout), 
url(r'Awiki/', include('wiki.urls')), 


在 wiki 目录 下 增加 一 个 urls.py 的 文件 ， 然 后 编辑 内 容 增加 了 wiki 等 4 个 url 映射 。 


from django.conf.urls import url 
from . import views 


urlpatterns = [ 
url(r'4$', views.index), 
url(r'4(?P<pagename>\w+)/$', views.index), 
url(r'4(?P<pagename>\w+)/edit/$', views.edit), 
url(r'4(?P<pagename>\w+)/save/$', views.save), 


这 里 要 好 好 讲 一 讲 URL 的 设计 (个 人 所 见 )。 
一 般 一 个 wiki ， 我 们 访问 它 的 一 个 页 面 可 能 为 : wiki/pagename。 因 此 我 设计 对 index() 方法 
的 调用 的 url A: 


r'Awiki/(?P<pagename>\w+)/$' 


也 就 是 把 Wiki/ 后 面 的 解析 出 来 作为 pagename 参数 。 但 这 样 就 带 来 一 个 问题 ， 如 果 我 想 实现 
wiki/edit.html 表示 修改 ， pagename 作为 一 个 参数 通过 POST 来 提交 好 象 就 不 行 了 。 因 为 
上 面 的 解析 规则 会 “ 吃 " 掉 这 种 情况 。 因 此 我 采用 Zope 的 表示 方法 : 把 对 象 的 方法 放 在 对 象 的 
后 面 。 我 可 以 把 pagename 看 成 为 一 个 对 象 ， edit , save 是 它 的 方法 ， 放 在 它 的 后 面 ， 也 
简单 ， 也 清晰 。 当 然 如 果 我 们 加 强 上 面 的 正则 表达 式 ， 也 可 以 解析 出 wiki/edit.html 的 情 
况 ， 但 那 就 是 你 设计 的 问题 了 。 这 里 就 是 我 的 设计 。 

因此 wiki/pagename 就 是 显示 一 个 页 面 ，wiki/pagename/edit 就 是 编辑 这 个 页 面 ， 
wiki/pagename/save 就 是 保存 页 面 。 而 pagename 解析 出 来 后 就 是 分 别 与 index() , 

edit() , save() 的 pagename 参数 相对 应 。 

下 面 你 可 以 运行 了 。 

11 启动 server 进入 (http://localhost:8000/wiki) 


首先 进入 这 个 页 面 : 
FrontPage 


Welcome to easy Wiki 





然后 你 点 编辑 ， 则 进入 FrontPage 的 编辑 界面 : 


纲 辑 :FrontPage 





Welcome to easy Wiki 


TestPagel 











RAF 


然后 我 们 加 上 一 个 TestPage ， 它 符合 wiki 的 名 字 要 求 ， 两 个 首 字母 大 写 的 单词 连 在 一 起 。 
然后 点 击 保存 。 


FrontPage 


Welcome to easy Wiki 
TestPage 





看 见 了 吧 。 页 面 上 的 TestPage 有 了 链接 。 点 击 它 将 进入 : 
纲 辑 :TestPage 
这 是 新 的 页 面 


有 返回 站 页 FrontPage 














保存 


这 是 TestPage 的 编辑 页 面 。 让 我 们 输入 中 文 ， 然 后 输入 FrontPage 。 然 后 保存 。 


TestPage 


这 是 新 的 页 面 
返回 首页 FrontPage 





好 了 ， 剩 下 的 你 来 玩 吧 。 点 击 FrontPage 将 回 到 首页 。 


Django Step by Step (七 ) 


1 引言 


敢 问 路 在 何方 ， 路 在 脚本 。 如 果 你 坚持 下 来 ， 一 定 会 有 收获 的 。 
直到 目前 我 们 已 经 学 了 : 


e settings.py 的 设置 
e url dispatcher 

o 模板 

e session 

e app 

e model 


其 实在 某 些 方面 ， 使 用 Django 还 可 以 更 加 方便 。 而 且 我 们 还 有 许多 东西 没有 学 ， 一 点 点 跟着 
我 学 吧 。 


我 有 一 个 通讯 录 ， 它 是 保存 在 Excel 文件 中 的 ， 我 不 想 每 次 到 目录 下 去 打开 它 ， 我 希望 用 
Django 做 一 个 web 上 的 简单 应 用 ， 如 何 做 呢 ? 


2 创建 address app 


python manage.py startapp address 


这 样 就 创建 好 了 address 相关 的 目录 了 。 


3 修改 address/models.py 


from django.db import models 


class Address(models.Model): 
name = models.CharField('#:%', max_length=6, unique=True) 
gender = models.CharField('t##|', choices=(('M', '%'), ('F', '%')), 
max_length=1) 
telphone = models.CharField('%7&', max_length=20) 
mobile = models.CharField('#7#u', max_length=11) 


这 回 model 复杂 多 了 。 在 上 面 你 可 以 看 到 我 定义 了 四 个 字段 : name, gender , telpnone , 
mobile 。 其 中 gender 表示 性 别 ， 它 可 以 从 一 个 tuple 数据 中 进行 选取 。 并 且 在 后 面 的 
radio_admin=True 表示 在 admin 的 管理 界面 中 将 使 用 radio 按钮 来 处 理 。 


Note 


Django 提供 了 许多 的 字段 类 型 ， 有 些 字 段 类 型 从 数据 的 取 值 范围 来 讲 没有 什么 区 别 ， 但 
之 所 以 有 这 种 区 别 ， 是 因为 : Django 的 数据 类 型 不 仅仅 用 于 创建 数据 库 ， 进 行 ORM 处 
理 ， 还 用 于 admin 的 处 理 。 一 方面 将 用 来 对 应 不 同 的 UI 控件 ， 另 一 方面 提供 对 不 同 的 


数据 类 型 将 进行 不 同 的 数据 校 验 的 功能 。 


在 Django 中 每 个 字段 都 可 以 有 一 个 提示 文本 ， 它 是 第 一 个 参数 ， 如 果 没 有 则 会 使 用 字段 名 。 
因此 我 定义 的 每 个 字段 为 了 方便 都 有 一 个 对 应 的 汉字 提示 文本 。 


因为 本 节 主 要 是 讲 admin 的 使 用 。admin 是 Django 提供 的 一 个 核心 app( 既 然 是 app 就 需要 
安装 ， 一 会 就 看 到 了 )， 它 可 以 根据 你 的 modell 来 自动 生成 管理 界面 。 我 为 什么 要 用 它 ， 因 为 
有 了 这 个 管理 界面 ， 对 于 通讯 录 的 增加 、 删 除 、 修 改 的 处 理 界面 完全 可 以 通过 admin 来 自动 
生成 ， 我 不 用 自己 写 。 不 相信 吗 ? 我 们 就 会 看 到 了 。 


ABA admin 到 底 可 以 带 来 些 什么 好 处 呢 ? 它 的 功能 很 强大 ， 不 仅 界 面 漂亮 ， 还 能 对 数据 提供 
操作 记录 ， 提 供 搜索 。 特 别 是 它 是 在 用 户 权 限 控 制 之 下 ， 你 都 可 以 不 用 考虑 安全 的 东西 了 。 

并 且 它 本 身 就 是 一 个 非常 好 的 学 习 的 东西 ， 特 别 是 界面 自动 生成 方面 ， 学 习 它 的 代码 可 以 用 
在 我 们 自己 的 定制 之 中 。 当 然 ， 你 许 你 用 不 上 admin ， 它 的 确 有 一 定 的 适应 范围 ， 不 过 对 于 
大 部 分 工作 来 说 它 可 能 足够 了 。 对 于 那些 交互 性 强 的 功能 ， 你 可 能 要 自己 实现 许多 东西 ， 对 
于 管理 集中 ， 主 要 以 发 布 为 主 的 东西 ， 使 用 它 可 以 节省 你 大 量 的 时 间 。 至 于 怎么 使 用 ， 你 要 
自己 去 权衡 。 但 这 一 点 对 于 快速 实现 一 个 web 应用， 作用 非常 大 ， 这 是 Django 中 的 一 个 亮 
Xo 


4 修改 settings.py 


INSTALLED_APPS = ( 
‘django.contrib.admin', 
"django.contrib.auth', 
"django.contrib.contenttypes', 
"django.contrib.sessions', 
'django.contrib.messages', 
"django.contrib.staticfiles', 
"newtest', 
"wiki.apps.WikiConfig', 
"address.apps.AddressConfig', 


第 七 讲 通讯 录 的 例子 


这 里 我 们 加 入 了 Address 的 app ， 我 们 注意 到 系统 默认 就 已 经 添加 了 admin 的 应 用 ， 就 是 
django.contrib.admin 。 admin 也 是 一 个 应 用 ， 需 要 加 入 INSTALLED_APPS 才 可 以 使 用 ， 这 
些 与 标准 的 app 的 安装 没有 什么 不 同 。 


5 安装 address app 


python manage.py makemigrations 
python manage.py migrate 


这 样 将 在 数据 库 中 创建 address 相关 的 表 。 


6 增加 超级 用 户 


入 (http://localhost:8000/admin) 


Django administration 


Username: 


Password: 


AAA o k o RAP oo admin 功能 是 有 用 户 权限 管理 的 ， 因 此 一 个 admin 替 你 完 
peek 用 户 的 管理 和 信息 的 增加 、 删 除 、 修 改 这 类 功能 类 似 ， 开 发 蒙 琐 的 东西 。 

么 我 们 目前 还 没有 一 个 用 户 ， 因 此 可 以 在 命令 下 创建 一 个 超级 用 户 ， 有 了 这 个 用 户 ， 以 后 
以 直接 在 admin 界面 中 去 管理 了 。 


python manage.py createsuperuser 


它 会 让 你 输入 用 户 名 ， 邮 件 地 址 和 口令 。 


再 进去 看 一 下 吧 。 
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第 七 讲 通讯 录 的 例子 


WELCOME ADMIN. VIEW SITE/ CHANGE PASSWORD /LOG OUT 





Site administration 


| 
Recent actions 
Groups 十 Add = # Change 
Users +Add = # Change My actions 


None available 


上 面 已 经 有 一 些 东 西 了 ， 其 中 就 有 用 户 管理 。 但 如 何 通 过 admin 增加 通讯 录 呢 ? 别 急 ， 我 们 
需要 编辑 一 下 address/admin.py， 告 诉 admin 应 用 我 们 的 Address 对 象 可 以 被 admin 管 理 。 


Note 


因此 是 否 启 用 admin 管理 取决 于 你 。 只 要 在 address/admin.py 中 增加 admin 相关 的 部 
分 ， 我 们 的 应 用 才 可 以 在 admin 中 被 管理 。 


7 修改 address/admin.py 


from django.contrib import admin 
# Register your models here. 
from .models import Address 


admin.site.register (Address) 


有 了 这 个 东西 ， 你 就 可 以 在 admin 中 看 到 adress 这 个 app 了 。 再 到 浏览 器 中 看 一 下 是 什么 
样子 了 。 





Site administration 


Addresss 十 Add # Change 
AUTHENTICATION AND AUTHORIZATION 

Groups 十 Add # Change 
Users 十 Add # Change 


看 见 了 吧 。 上 面 有 增加 和 删除 的 按钮 ， 先 让 我 们 点 击 一 下 增加 吧 。 
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第 七 讲 通讯 录 的 例子 


WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD /LOG OUT 


Home> Address > Addresss » Add address 





Add address 
姓名 : 日 
en = 4 
电话 : 


手机 : 


Save and add another Save and continue editing 


这 个 自动 生成 的 界面 是 不 是 很 不 错 。 增 加 一 条 保存 起 来 了 。 不 过 我 发 现 当 我 输入 limodou 
时 ， 只 能 输入 limodo 好 象 u 输 不 进去 。 为 什么 ? 因为 我 把 姓名 按 汉 字 算 最 多 6 个 就 够 了 ， 
一 旦 我 使 用 英文 的 名 字 可 能 就 不 够 。 因 此 这 是 一 个 问题 ， 一 会 要 改 掉 。 


WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Home> Address » Addresss 





© The address "Address object" was added successfully. 


Select address to change 


Action: | --------- $|| Go | Oof1 selected 


O ADDRESS 


O Address object 


1 address 
怎么 新 增 的 记录 叫 


这 样 看 上 去 很 别扭 。 为 什么 会 这 样 ， 因 为 没有 定义 特殊 的 方法 。 下 面 就 让 我 们 定义 一 下 。 


8 修改 address/models.py 
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第 七 讲 通讯 录 的 例子 


from django.db import models 
# Create your models here. 


class Address(models.Model): 
name = models.CharField('#:2', max_length=6, unique=True) 
gender = models.CharField('t=%|', choices=(('M', '%'), ('F', '%')), 
max_length=1) 
telphone = models.CharField('%i', max_length=20) 
mobile = models.CharField('##u', max_length=11) 


def str (self): 


return self.name 


改 好 了 ， 再 刷新 下 页 面 。 这 次 看 见 了 吗 ? 了 增加 了 一 个 str 方法 。 这 个 方法 将 在 显示 Address 
实例 的 时 候 起 作用 。 我 们 就 使 用 某 个 联系 人 的 姓名 就 行 了 。 


Home > Address > Addresss 





Select address to change 


Action: | --------- || Go | Oof1 selected 


1 address 


你 记得 吗 ? Model 是 与 数据 库 中 的 表 对 应 的 ， 为 什么 我 们 改 了 model 代码 ， 不 需要 重新 对 数 
据 库 进行 处 理 呢 ? 因为 只 要 不 涉及 到 表 结 构 的 调整 是 不 用 对 表 进 行 特 殊 处 理 的 。 不 过 ， 我 们 
马上 要 修改 表 结 构 了 。 


9 修改 address/models.py 


姓名 留 短 了 引 是 不 方便 ， 另 外 我 突然 发 现 需 要 再 增加 一 个 房间 字段 。 
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from django.db import models 
# Create your models here. 
class Address(models.Model): 
name = models.CharField('#:%', max_length=20, unique=True) 
gender = models.CharField('#]', choices=(('M', '%'), ('F', 'x*')), 
max_length=1) 
telphone = models.CharField('‘27&', max_length=20) 
mobile = models.CharField('#7#u', max_length=11) 
room = models.CharField('//4]', max_length=10, default='') 
def str (selfe 


return self.name 


回 表 结构 要 改变 了 ， 怎 么 做 呢 ? 


10 修改 表 结 


我 们 可 以 使 用 Een doen lente 千 移 功能 ， 在 不 影响 原 有 数据 的 情况 下 ， 更 新 表 结 构 。 主 要 
包括 下 面 的 命 外 令 


。 migrate， 负 责 应 用 迁移 ， 以 及 取消 应 用 并 列 出 其 状态 。 
e makemigrations, 负责 基于 你 的 模型 修改 创建 一 个 新 的 迁 
e sqlmigrate, 展示 迁移 的 sql 语句 


大 家 一 定 已 经 注意 到 了 ， 我 们 增加 的 字段 room 多 了 一 个 默认 值 空 字符 串 ， 这 是 为 i 
个 新 的 字段 中 之 后 ， 可 以 使 用 这 个 默认 值 十 充 已 有 的 记录 。 下 面 我 们 创建 一 个 新 的 迁 


python manage.py makemigrations 


el 就 在 address/migrations 目 录 下 得 到 了 一 个 新 的 0002_auto_XXXXXXXX_XXXX. py | 
e 这 个 文件 由 Django 自 动 生 成 ， 用 于 迁移 数据 库 使 用 ， 我 们 不 用 管 它 ， 使 用 下 面 的 命令 
迁移 : 


python manage.py migrate 


现在 数据 库 中 已 经 是 新 的 表 结 构 了 ， 我 们 可 以 对 数据 继续 进行 操作 。 


11 进入 admin 


我 们 可 以 再 次 进入 admin 了， 增加， 删除， 修改 数据 了 。 


用 了 一 会 ， 也 许 你 会 希望 : 能 不 能 有 汉化 版 本 的 界面 呢 ? 答案 是 肯定 的 ， 而 且 已 做 好 了 。 


12 修改 settings.py 
在 MIDDLEWARE 部 分 ， 增 加 django.middleware.locale.LocaleMiddleware °’ 代码 如 下 : 


MIDDLEWARE = [ 
"django.middleware.security.SecurityMiddleware', 
"django.contrib.sessions.middleware.SessionMiddleware', 
"django.middleware.common.CommonMiddleware', 
"django.middleware.csrf.CsrfViewMiddleware', 
‘django.contrib.auth.middleware.AuthenticationMiddleware', 
"django.contrib.messages.middleware.MessageMiddleware', 
'django.middleware.clickjacking.XFrameOptionsMiddleware', 
"django.middleware.locale.LocaleMiddleware', 


刷新 下 界面 ， 是 不 是 变 成 汉字 了 。 


国际 化 支持 在 Django 中 做 得 是 非常 的 出 色 ， 程 序 可 以 国际 化 ， 模 板 可 以 国际 化 ， 其 至 js 都 可 
以 国际 化 。 这 一 点 其 它 的 类 似 框架 都 还 做 不 到 。 而 国际 化 的 支持 更 是 ROR 的 一 个 弱项 ， 
在 Snakes and Rubies 的 会 议 上 ，RoR 的 作者 都 不 想 支 持 国际 化 。 但 Django 却 做 得 非常 

色 ， 目 前 已 经 有 二 十 多 种 语言 译文 。 


在 增加 ， 删 除 ， 修 改 都 做 完了 ， 其 实 还 剩 下 什么 呢 ? 显示 和 查询 。 那 么 实现 它 则 需要 写 view 
和 使 用 模板 了 。 这 个 其 实 也 没什么 ， 最 简单 的 ， 从 数据 库 里 查询 出 所 有 的 数据 ， 然 后 调用 模 
板 ， 通 过 循环 一 条 条 地 显示 。 不 错 是 简单 。 但 是 在 做 之 前 ， 先 让 我 们 想 一 想 ， 这 种 处 理 是 不 
是 最 常见 的 处 理 方法 呢 ? 也 许 我 们 换 成 其 Bn oe nah 。 如 果 很 多 这 样 的 处 理 ， 
是 不 是 我 们 需要 每 次 都 做 一 遍 呢 ?3 有 没有 通用 的 方便 的 方法 。 答 案 是 : A! Django 已 经 为 我 
们 想到 了 ， 这 就 是 Generic views 所 做 的 。 它 把 最 常见 的 显示 列表 ， 显 示 详 细 信 息 ， 增 加 ， 修 
改 ， 删 除 对 象 这 些 处 理 都 已 经 做 好 了 一 个 通用 的 方法 ， 一 旦 有 类 似 的 处 理 ， 可 以 直接 使 用 ， 
不 用 再 重新 开发 了 。 但 在 配置 上 有 特殊 的 要 求 。 具 体 的 可 以 看 Generic views 文档 。 


从 这 里 我 有 一 点 想法 ， 我 认为 view 这 个 名 称 特别 容易 让 人 产生 误解 ， 为 什么 呢 ? 因为 view 
可 以 译 为 视图 ， 给 人 一 种 与 展示 有 关 的 什么 东西 。 但 实际 上 Django 中 的 view 相当 于 一 个 
Controller 的 作用 ， 它 是 用 来 收集 数据 ， 调 用 模板 ， 申 正 的 显示 是 在 模板 中 处 理 的 。 因 此 我 倒 
认为 使 用 Controller 可 能 更 合适 ， 这 样 就 称 为 MTC 了 了。 呵呵， 只 是 个 人 想法 。 


另外 ，Generic views 产生 的 意义 在 于 Django 的 哲学 理 含 DRY (Don't repeat yourself, 不 要 
自己 重复 ) ， 目 的 是 重用 ， 减 少 重复 劳动 。 还 有 其 它 的 哲学 理 含 参见 Design philosophies 文 
档 。 


因此 可 以 知道 view 可 以 极 大 地 简化 ，Django 在 这 点 上 认为 : 每 个 应 用 的 显示 都 可 能 是 不 同 
的 ， 因 此 这 件 事 需 要 用 户 来 处 理 。 但 如 果 有 最 简单 的 封装 ， 对 于 开发 人 员 在 测试 时 会 更 方 
便 ， 但 目前 没有 ， 因 此 模板 我 们 还 是 要 准备 ， 而 且 还 有 特殊 的 要 求 ， 一 会 就 看 到 了 。 


对 于 目前 我 这 个 简单 的 应 用 来 说 ， 我 只 需要 一 个 简单 的 列表 显示 功能 即 可 ， 好 在 联系 人 的 信 
息 并 不 多 可 以 在 一 行 显示 下 因此 我 要 使 用 django.views.generic 模块 来 处 理 。 


13 增加 address/urls.py 
对 ， 我 们 为 address 应 用 增加 了 自己 的 urls.py ° 


from django.conf.urls import url 
from . import views 
urlpatterns = [ 


url(r'A$', views. IndexView.as_view(), name='index'), 


] 


我 们 使 用 as_view 这 个 generic view 的 方法 显示 默认 的 列表 界面 ， 可 以 大 大 的 简化 views.py 的 
编码 工作 ， 现 在 我 们 的 views.py 代 码 如 下 : 


from django.views import generic 


from .models import Address 


class IndexView(generic.ListView): 
model = Address 
template_name = 'address_list.html' 


我 们 只 需要 从 generic.Listview 继承 ， 并 创建 一 个 基于 类 的 View， 命 名 为 Indexview ° AG 
为 这 个 类 设置 两 个 成 员 变 量 ， 一 个 为 model = address ， 指 定 我 们 的 generic view 需 要 显示 哪 
一 个 模型 的 数据 ; 再 设置 template_name = 'address_list.html' ， 指定 显示 的 模板 。 


前 面 已 经 谈 到 : 使 用 generic view 只 是 减少 了 view 的 代码 量 ， 但 对 于 模板 仍然 是 必 不 可 少 
的 。 因 此 要 创建 符合 generic view 要 求 的 模板 。 主 要 是 模板 存放 的 位 置 和 模板 文件 的 名 字 。 


缺 省 需要 的 模板 文件 名 为 : app_label/model_name_list.html ， 在 这 个 模板 中 可 以 使 用 
object_list 变量 访问 模型 的 列表 。 


14 在 address 中 创建 templates 子 目 录 


15 创建 address/templates/address/list.html 


<h1> 通 讯 录 </h1> 
<hr> 
<table border="1"> 
SES 
<th> 姓 名 </th> 
<th> 性 别 </th> 
<th> 电 话 </th> 
<th> 手 机 </th> 
<th> 房 间 </th> 
</tr> 
{% for person in address_list %} 
Sele. 
<td>{{ person.name }}</td> 
<td>{{ person.gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 
</tr> 
{% endfor %} 
</table> 


16 修改 urls.py 
将 我 们 的 应 用 的 urls.py include 进去 。 


from django.conf.urls import include, url 
from django.contrib import admin 
from . import helloworld, add, list, xls_test, login 


urlpatterns = [ 
url(r'Aadmin/', admin.site.urls), 
url(r'^$', helloworld. index), 
url(r'^add/$', add.index), 
url(r'Alist/$', list.index), 
url(r'xls/(?P<filename>\w+)/$', xls_test.output), 
url(r'Alogin/$', login.login), 
url(r'Alogout/$', login. logout), 
url(r'Awiki/', include('wiki.urls')), 
url(r'\address/', include('address.urls')), 


可 以 看 到 r'aaddress/' 没有 使 用 $ ， 因 为 它 只 匹配 前 部 
urls.py 来 处 理 。 


yy 


> 后 面 的 留 给 address 中 的 


17 启动 server 看 效果 
通讯 录 


' 姓名 “性别 电话 | “手机 房间 
Limodou|M (1111 11111111111|1111 





Django Step by Step ( 八 ) 


上 一 讲 的 确 很 长 ， 但 如 果 看 代码 你 会 发 现 ， 代 码 主要 在 model 的 调整 中 ， urls.py 的 工作 不 
多 ， 而 连 一 行 view 的 代码 都 没有 写 。 是 不 是 非常 方便 呢 ! 
那么 让 我 们 来 继续 完善 这 个 通讯 录 吧 。 
现在 我 想 完成 的 是 : 

。 增加 批量 导入 和 导出 功能 
为 什么 要 批量 导入 呢 ? 因为 一 般 情况 下 ， 我 一 定 是 已 经 有 了 一 个 通讯 录 文 件 ( 象 以 前 我 说 过 的 
Excel #+)° 那么 现在 需要 转 到 web 上 来 ， 难 道 要 我 一 条 条 全 部 手工 录入 吗 ? 能 不 能 上 传 文 
件 ， 自 动 插入 到 数据 库 中 去 呢 ? 那么 就 让 我 们 实现 一 个 文件 上 传 的 处 理 吧 。 
为 了 简化 ， 我 采用 csv 格 式 文本 文件 (这 个 文件 在 svn 中 有 一 个 例子 data.csv ， 不 然 就 自行 生 
成 好 了 )。 

abc, M, 11, 11, 11， 

bcd, M, 11,11,11, 

ass,M, 11, 11, 11, 


dfsdf,F,11,11,11, 
sfas, F, 11,11,11, 


2 修改 address/templates/address/list.html 


<h1 id="title"> 通 讯 录 </h1> 
<hr> 
<form enctype="multipart/form-data" method="POST" action="/address/upload/"> 
上 传 通讯 录 文 件 : <input type="file" name="file"/><br/> 
<input type="submit" Value=" 上 传 文件 "/> 
</form> 
<table border="1"> 
<he 
<th> 姓 名 </th> 
<th> 性 别 </th> 
<th> 电 话 </th> 
<th> 手 机 </th> 
<th> 房 间 </th> 
</tr> 
{% for person in address_list %} 
<tr> 
<td>{{ person.name }}</td> 
<td>{{ person.gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 
KAE 
{% endfor %} 
</table> 


3 修改 address/views.py 


from django.http import HttpResponseRedirect 
from django.shortcuts import render_to_response 
from django.views.decorators.csrf import csrf_exempt 


@csrf_exempt 
def upload(request): 
file_obj = request.FILES.get('file', None) 
if file_obj: 
import csv 
from io import StringIO 
en 
csvfile = StringI0(file obj.read().decode()) 
reader = csv.reader(csvfile) 
except: 
return render_to_response('address/error.html', 
{'message':' 你 需要 上 传 一 个 csv 格 式 的 文件 ! '}) 
for row in reader: 
objs = Address.objects. filter (name=row[0] ) 
if not objs: 
obj = Address(name=row[0], gender=row[i], 
telphone=row[2], mobile=row[3], room=row[4]) 
elise: 
obj = objs[0] 
obj.gender = row[1] 
obj.telphone = row[2] 
obj.mobile = row[3] 
obj.room = row[4] 
obj .save() 


return HttpResponseRedirect('/address/' ) 
elise: 
return render_to_response('address/error.html', 
{'message' :你 需要 上 传 一 个 文件 1 'F) 


这 里 有 一 个 upload() 方法 ， 它 将 使 用 csv 模块 来 处 理 上 传 的 csv 文件 。 首 先 查找 姓名 是 否 
存在 于 数据 库 中 ， 如 果 不 存 在 则 创建 新 记录 。 如 果 存 在 则 进行 替换 。 如 果 没 有 指定 文件 直接 
上 传 ， 则 报告 一 个 错误 。 如 果 解 析 csv 文件 出 错 ， 则 也 报告 一 个 错误 。 


报 造 错误 使 用 了 一 个 名 为 error 的 模板 ， 我 们 马上 要 创建 。 


4 创建 address/templates/address/error.html 


<h2> 出 错 </h2> 

<p>{{ message }}</p> 

<hr> 

<p><a href="/address/">i& El</a></p> 


很 简单 。 


5 修改 address/urls.py 


from django.conf.urls import url 
from . import views 


urlpatterns = [ 
url(r'^$', views. IndexView.as_view(), name='index'), 
url(r'Aupload/$', views.upload), 


34 Ja — upload 的 url 映射 。 


6 2a server 测试 
这 样 导 入 功能 就 做 完了 。 那 导出 呢 ?很 简单 了 了， 参考 csv 的 例子 去 做 就 可 以 了 。 不 过 ， 并 不 


全 是 这 样 ， 仍 然 有 要 修改 的 地 方 ， 比 如 csv.html 模板 ， 它 因为 写 死 了 处 理 几 个 元 素 ， 因 此 需 
要 改 成 一 个 循环 处 理 。 


7 修改 address/templates/address/csv.html 


{% for row in data %}{% for i in row %}"{{ iladdslashes }}",{% endfor %} 
{% endfor %} 


将 原来 国定 个 数 的 输出 改 为 循环 处 理 。 


8 修改 address/templates/address/list.html 


增加 一 个 生成 导出 的 csv 文件 的 链接 


<h1 id="tit1le"> 通 讯 录 </h1> 
<hr> 
<form enctype="multipart/form-data" method="POST" action="/address/upload/"> 
上 传 通讯 录 文 件 : <input type="file" name="file"/><br/> 
<input type="submit" value=" 上 传 文件 "/> 
</form> 
<hr> 
<p><a href="/address/output/"> 导 出 为 csv 格 式 文件 </a></p> 
<table border="1"> 
<tr> 
<th> 姓 名 </th> 
<th> 性 别 </th> 
<th> 电 话 </th> 
<th> 手 机 </th> 
<th> 房 间 </th> 
</tr> 
{% for person in object_list %} 
<tr> 
<td>{{ person.name }}</td> 
<td>{{ person.gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 
</tr> 
{% endfor %} 
</table> 


9 修改 apps/address/views.py 


from django.http import HttpResponse 
from django.template import loader, Context 


def output(request): 
response = HttpResponse(content_type='text/csv') 
response['Content-Disposition'] = 'attachment; filename=%s' % 'address.csv' 


t = loader.get_template('address/csv.html') 
objs = Address.objects.all() 
d = [] 
for o in objs: 
d.append((o.name, o.gender, o.telphone, o.mobile, o.room)) 
c = {'data': d,} 
response.write(t.render(c) ) 
return response 


在 开始 处 增加 了 对 HttpResponse , loader , Context 的 导入 。 然 后 增加 了 用 于 输出 处 理 的 
output() 方法 。 


10 修改 address/urls.py 


from django.conf.urls import url 
from . import views 
urlpatterns = [ 
url(r'^$', views. IndexView.as_view(), name='index'), 


url(r'Aupload/$', views.upload), 
url(r'Aoutput/$', views.output), 


增加 了 对 output 方法 的 url 映射 。 


11 È Z server 测试 


Django Step by Step (7t) 


wh 


1 引 


不 知道 大 家 有 没有 对 这 个 通讯 录 感 到 厌烦 了 ， 硕 望 没有 ， 因 为 还 有 一 些 东西 没有 讲 完 呢 。 


最 让 我 感觉 不 满意 的 就 是 通讯 录 的 显示 了 ， 的 确 很 难看 ， 和 希望 可 以 美化 一 下 。 那 么 主要 从 这 
几 方 面 : 


o 对 姓名 进行 排序 
© 生成 分 页 结果 
e 增加 css 和 一 些 图 片 


2 修改 address/models.py 实现 排序 


可 以 在 model 中 增加 一 个 叫 meta 的 内 类 ， 然 后 通过 对 其 设置 类 属性 可 以 用 来 控制 model 的 
模型 属性 。 如 我 们 想 实 现 表 的 排序 ， 可 以 在 meta 中 增加 一 个 ordering = ['name'] 的 属性 
PPT o 它 表示 按 name 进行 排序 ° 它 可 以 有 多 个 字段 3 如 果 在 字段 前 加 '-' 表 示 倒 序 © 修改 完 
毕 在 浏览 器 中 看 一 下 效果 就 知道 了 。models.py 的 代码 如 下 


from django.db import models 


class Address(models.Model): 
name = models.CharField('#:2', max_length=20, unique=True) 
gender = models.CharField('/2%#|', choices=(('M', '4%'), ('F', '*')), 
max_length=1) 
telphone = models.CharField('%7&', max_length=20) 
mobile = models.CharField('#7#u', max_length=11) 
room = models.CharField('//4', max_length=10, default='') 


def Sense 并 
return self.name 


class Meta: 
ordering = ["name"] 


3 修改 templates/address/address/list.html 实现 


<html> 
<head> 
</head> 
<body> 
<h1 id="title">i#1AR</h1> 
<hr> 
<div> 
{% if is_paginated %} 
<table border="0" width="500"> 
<tr align="right"> 
<td> 
{% if page_obj.has_previous %} 
<a href="/address?page={{ page_obj.previous_page_number }}"> 上 一 页 </a> 
{% endif %} 
{% if page_obj.has_next %} 
<a href="/address?page={{ page_obj.next_page_number }}"> 下 一 页 </a> 
{% endif %} 
</td> 
</tr> 
</table> 
{% endif %} 
<table border="1" width="500"> 
<tr> 
<th> 姓 名 </th> 
<th> 性 别 </th> 
<th> 电 话 </th> 
<th> 手 机 </th> 
<th> 房 间 </th> 
</tr> 
{% for person in address_list %} 
<tr> 
<td>{{ person.name }}</td> 
<td>{{ person.gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 


AE> 
{% endfor %} 
</table> 
</div> 
<table border="0" width="500"> 
-Re 
<td> 
<form enctype="multipart/form-data" method="POST" action="/address/upload/"> 
文件 导入 : 
<input type="file" name="file" /> 
<br/> 
<input type="submit" value=" 上 传 文件 " /> 
</form> 
</td> 
<td> 


<p> 


<a href="/address/output/"> 导 出 为 CsVv 文 件 </a> 
</p> 
</td> 
</tr> 
</table> 
</body> 
</html> 


这 时 我 仍然 使 用 的 是 generic view 来 处 理 。 但 对 布局 作 了 简单 的 调整 ， 将 导入 和 导出 的 内 容 
移 到 下 面 去 了 。 同 时 增加 了 对 分 页 的 支持 : 


{% if page_obj.has_previous %} 

<a href="/address?page={{ page_obj.previous_page_number }}"> 上 一 页 </a> 
{% endif %} 

{% if page_obj.has_next %} 

<a href="/address?page={{ page_obj.next_page_number }}"> 下 一 页 </a> 

{% endif %} 


在 使 用 generic view 的 object_list 时 ， 它 会 根据 URL Dispatch 中 是 否 设 置 了 

paginate_by 这 个 参数 来 决定 是 否 使 用 分 页 机 制 。 一 会 我 们 会 看 到 在 urls.py 的 这 个 参数 。 
一 旦 设置 了 这 个 参数 ， 则 object_list 会 使 用 Django 提供 的 一 个 分 页 处 理 器 来 实现 分 页 。 
它 会 自动 产生 分 页 所 用 到 的 许多 的 变量 ， 这 里 我 们 使 用 了 has_previous ，previous , 
has_next ，next 这 四 个 变量 ， 还 有 其 它 一 些 变量 可 以 使 用 。 具 体 的 参见 Generic views X 
档 。 


这 里 是 根据 是 否 有 前 一 页 和 下 一 页 来 分 别 生 成 相应 的 链接 。 对 于 分 页 的 链接 ， 需 要 在 url 中 增 
加 一 个 Query 关键 字 page ° 因此 我 的 模板 中 会 使 用 page={{ previous }} 和 page={{ next 
}} 分 别 指向 前 一 页 和 下 一 页 的 页 码 。 


4 修改 address/views.py 


class IndexView(generic.ListView) : 
model = Address 
template_name = ‘address/list.html' 
paginate_by = 2 


我 们 为 Indexview 类 增加 一 个 成 员 变量 : paginate by ， 指 定 每 一 页 显示 2 条 记录 。 


后 动 Server 测试 


通讯 录 












































下 一 页 
姓名 性 别 | 电话 | 手机 | 房间 
abc Mo td hi 11 
aksdhf F 11 1 ‘11 
alfj M 11 jf 11 
aosfdu M 11 ‘11 ‘11 
ass M 11 ul I 
auf F 11 11 ‘11 
bed M 11 11 ‘11 
dfsdf F 1 fii 11 
ewrga F faa [i 11 
fafasf F 加 fit il 
文件 导入 ，[ (ooo 
导出 为 csv 文 件 


下 面 让 我 们 为 它 添加 一 些 CSS 和 图 片 ， 让 它 变 得 好 看 一 些 。 


首先 要 说 明 一 下 ， 我 们 一 直 处 于 开发 和 测试 阶段 ， 因 此 我 们 一 直 使 用 的 都 是 Django 自 带 的 
server( 其 实 我 个 人 感觉 这 个 Server 的 速度 也 挺 快 的 )， 但 最 终 我 们 的 目的 是 把 它 部 署 到 
Apache 上 去 。 现 在 我 们 打算 增加 CSS 和 添加 一 些 图 片 ，Django 提供 了 这 个 能 力 ， 这 就 是 
对 静态 文件 的 支持 ， 但 是 它 只 是 建议 在 开发 过 程 中 使 用 。 申 正 到 了 实际 环境 下 ， 还 是 让 专门 
的 web server 如 Apache 来 做 这 些 事情 。 只 要 改 一 下 链接 设置 就 好 了 。 更 详细 的 说 明 要 参见 
Managing static files 的 文档 。 同 时 在 Django 中 为 了 不 让 你 依赖 这 个 功能 ， 特 别 在 文档 的 开 
始 有 强烈 的 声明 : 使 用 这 个 方法 是 低 效 和 不 安全 的 。 同 时 当 DEBUG 设置 (在 settings.py 中 
有 这 个 选项 ， True 表示 处 于 调试 期 ， 会 有 一 些 特殊 的 功能 ) 为 False 时 ， 这 个 功能 就 自动 
无 效 了 ， 除 非 你 修改 代码 让 它 生 效 。 


6 修改 urls.py 


from django.conf import settings 
from django.conf.urls.static import static 


urlpatterns = [ 
# ,,， 其 他 的 URL Pattern ... 
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) 


我 们 使 用 static 函 数 ， 它 需要 两 个 参数 。 第 一 个 参数 是 通过 URL 访 问 静 态 文件 时 的 相对 路 径 ， 
在 settings.py 文件 中 默认 设置 为 STATIC_URL = '/static/' ， 也 就 是 通 
过 http://yourhost/static/ 访问 静态 文件 ; 第 二 个 参数 是 静态 文件 在 服务 器 上 存放 的 路 


径 ， STATIC_ROOT 就 是 我 将 用 来 存放 CSS 和 图 片 的 地 方 ， 这 里 我 使 用 了 一 个 STATIC_PATH 
， 它 从 哪里 来 呢 ? 它 是 我 自己 在 settings.py 中 定义 的 。 在 前 面 有 一 个 导入 语 钨 : 


from django.conf import settings 


从 这 里 可 以 看 到 是 如 何 使 用 settings.py 的 ， 我 们 完全 可 以 自己 定义 新 的 东西 ， 并 让 它 在 整个 
项 目 中 生效 。 


7 修改 settings.py 
在 最 后 增加 : 


STATIC_ROOT = os.path.join(BASE_DIR, "collect_static/") 


STATICFILES_ DIRS = [ 
os.path.join(BASE_DIR, "static"), 
] 


STATIC_ROOT 这 个 字段 的 的 目录 路 径 是 用 来 为 部 署 而 收集 静态 文件 的 地 方 。 更 具体 的 说 
呢 ， 当 我 们 执行 python manage.py collectstatic 命令 的 时 候 ， 系 统 会 帮 我 们 把 所 有 的 静态 文 
件 都 收集 到 该 目录 下 。 STATICFILES_DIRS 上 默认 是 一 个 空 列表 ， 那 么 这 个 设置 定义 了 
staticfiles app 将 会 遍历 的 一 个 附加 的 位 置信 息 。 该 值 应 该 设置 为 一 个 字符 串 的 列表 形式 ， 每 
个 元 素 都 是 附加 文件 目录 的 绝对 路 径 。 


注意 : 这 些 路 径 都 应 该 使 用 unix 风 格 的 斜 本 ， 即 便 是 在 windows 平 台 上 


("C:/Users/user/mysite/extra_static_content") 


那么 我 需要 在 newtest A 录 下 创建 一 个 static 和 collect_static 的 目录 。 


8 创建 newtest/static 目录 


这 样 根据 上 面 urls.py 的 设置 ， 我 们 以 后 将 通过 /static/xxx 来 使 用 某 些 静态 文件 。 


为 了 美化 ， 我 想 需要 一 个 CSS 文件 来 定义 一 些 样式 ， 同 时 我 还 想 提供 一 个 Django Powered 
的 图 片 。 在 这 里 有 官方 提供 的 图 标 。 于 是 我 下 了 一 个 放 在 了 static 目录 下 。 同 时 CSS 怎 
么 办 ， 自 己 重头 写 ， 太 麻烦 ， 反 正 只 是 一 个 测试 。 于 是 我 下 载 了 Django 站 点 用 的 css 叫 
base.css 也 放 在 了 static 下面 。 下 面 就 是 对 模板 的 改造 。 


在 SVN 中 我 放 了 一 个 css 和 gif 图 片 大 家 可 以 使 用 ， 不 然 可 能 看 不 出 效果 。 


为 了 通用 化 ， 我 新 增 了 一 个 base. html 它 是 一 个 框架 2 而 以 前 的 address/list.html 是 它 的 
一 个 子 模板 。 这 样 我 们 就 可 以 了 解 如 何 使 用 模板 间 的 肯 套 了 。 


9 创建 newtest/templates/base.html 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http: //www.w3.org/TR/xhtmli/DTD/xhtm1i-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtmlL" xml:lang="en" lang="en"> 
<head> 
<meta http-equiv="Content-type" content="text/html; charset=utf-8" /> 
<meta http-equiv="Content-Language" content="en-us" /> 


<title>Address</title> 


<meta name="ROBOTS" content="ALL" /> 

<meta http-equiv="imagetoolbar" content="no" /> 

<meta name="MSSmartTagsPreventParsing" content="true" /> 

<meta name="Copyright" content="This site's design and contents Copyright (c) 
2005 Limodou." /> 


<meta name="keywords" content="Python, Django, framework, open-source" /> 
<meta name="description" content="Django is a high-level Python Web framework 
that encourages rapid development and clean, pragmatic design." /> 


<link href="/static/base.css" rel="stylesheet" type="text/css" media="screen" 
is 


</head> 


<body> 
<div id="container"> 
{% block content %}content{% endblock %} 
</div> 
<div id="footer"> 
<div> 
<img src="/static/djangopowered.gif"/> 
</div> 
<p>&copy; 2005 Limodou. Django is a registered trademark of Lawrence Journ 
al-World.</p> 
</div> 
</body> 
</html> 


有 些 代码 也 是 从 Django 的 网 页 中 拷贝 来 的 。 特 别 要 注意 的 是 : 


{% block content %}content{% endblock %} 


这 样 就 是 定 了 一 个 可 以 扩展 的 模块 变量 块 ， 我 们 将 在 address/list.htm 中 扩展 它 。 同 时 对 
CSS 和 Django-Powered 的 图 片 引 用 的 代码 是 : 


<link href="/static/base.css" rel="stylesheet" type="text/css" media="screen" /> 
<img src="/static/djangopowered.gif"/> 


前 面 都 是 从 static 开始 的 。 这 样 就 将 使 用 我 们 前 面 在 urls.py 中 的 设置 了 。 


10 修改 templates/address/address/list.html 


{% extends "base.html" %} 
{% block content %} 
<style type="text/css"> 


hi#title { 
color: black; 
} 
</style> 


<div id="header"> 
<h1 id="title">i&1A#</h1> 
</div> 
<hr> 
<div> 
{% if is_paginated %} 
<table border="0" width="500"> 
<tr align="right"> 
<td>{% if page_obj.has_previous %} 
<a href="/address?page={{ page_obj.previous_page_number }}"> 上 一 页 </a> 
{% endif %} {% if page_obj.has_next %} 
<a href="/address?page={{ page_obj.next_page_number }}"> 下 一 页 </a> 
{% endif %}</td> 
</tr> 
</table> 
{% endif %} 
<table border="1" width="500"> 
<tr> 
<th> 姓 名 </th> 
<th> 性 别 </th> 
<th> 电 话 </th> 
<th> 手 机 </th> 
<th> 房 间 </th> 
</tr> 
{% for person in address_list %} 
SENS 
<td>{{ person.name }}</td> 
<td>{{ person.gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 
</tr> 
{% endfor %} 
</table> 
</div> 


<table border="0" width="500"> 
<tr> 
<td> 
<form enctype="multipart/form-data" method="POST" action="/address/upload/"> 
文件 导入 : 
<input type="file" name="file" /> 
<br/> 
<input type="submit" value=" 上 传 文件 " /> 
</form> 
</td> 
<td> 
<p> 
<a href="/address/output/">$ i Acsvx </a> 
</p> 
</td> 
Aei 
</table> 
{% endblock %} 


基本 上 没有 太 大 的 变化 ， 主 要 是 增加 了 一 些 div 标签 ， 同 时 最 开始 使 用 : 
{% extends "base" %} 
表示 是 对 base 的 扩展 ， 然 后 是 相应 的 块 的 定义 : 


{% block content %} 


nice %} 
注意 ， 所 有 扩展 的 东西 一 定 要 写 在 块 语句 的 里 面 ， 一 旦 写 到 了 外 面 ， 那 样 就 不 起 作用 了 。 
Django 的 模板 可 以 不 止 一 次 的 扩展 ， 但 这 里 没有 演示 。 
11 后 动 server 测试 


现在 你 看 到 的 页 面 是 不 是 象 我 这 样 ? 













上 上 一 下 
[ s | oy | 电话 | m | 房间 | 
abc M ffs Ss 11 
esa FF mm pm aooo 
6 hm pm e 
ostu pm pm pm 
Ess ph pm pm pm o 
at FF pm ft 证 
bd np [m m 
fats | EE 
Ee 
文件 导入 : alec 


EAE 


12 重要 的 版 权 问题 









版 权 是 一 个 可 能 我 们 大 多 数 人 都 不 重视 的 问题 ， 但 在 实际 生产 中 ， 这 是 一 个 必须 重视 的 问 
题 。 许 多 东西 象 CSS, 图 片 ， 甚 至 可 能 是 一 种 布局 ， 设 计 都 有 可 能 有 版 权 ， 在 使 用 这 些 东西 的 
时 候 一 定 要 注意 相关 的 说 明 。 不 要 给 自己 造成 麻烦 。 如 果 你 不 清楚 ， 建 议 你 去 找 清楚 的 人 ， 
或 与 所 有 者 联系 。 特 别 是 对 于 开源 ， 版 权 更 是 一 个 很 重要 的 东西 ， 因 为 这 是 保护 我 们 的 武 

器 ， 硕 望 每 个 人 都 重视 。 特 别 是 对 于 正式 发 布 的 东西 ， 一 定 要 将 版 权 问 题 交 待 清楚 。 


Django Step by Step (十 ) 


14512 

现在 我 们 看 一 看 所 展示 出 来 的 页 ies 5? 还 有 可 oe 比如 性 别 ， 它 显 = 
来 的 直接 是 数据 库 的 值 ， eee he ais ge Tee 还 有 表格 显示 也 不 是 很 好 看 。 
说 的 ， 改 1 


最 初 我 想 使 用 CustomManipulator (Manipulator 是 Django 中 用 来 自动 生成 元 素 对 应 的 HTML 
代码 的 对 象 ， 你 可 以 定制 它 )， 但 使 用 Manipulator 的 话 ， 你 不 能 再 使 用 generic view 了 ， 需 
要 自己 去 实现 generic view 的 某 些 代码 ， 当 然 可 以 copy and paste， 但 我 目前 不 想 那样 做 。 
于 是 我 想到 可 以 扩展 Django 的 模板 ， 自 定义 一 个 filter 来 实现 它 。( 具 体 扩 展 的 文档 参见 The 
Django template language: For Python programmers ， 你 不 仅 可 以 扩展 filter， 还 可 以 扩展 
Tag ， 还 可 以 设置 模板 变量 ， 还 可 以 进行 块 处 理 等 复杂 的 操作 ， 自 己 去 看 吧 。) 


创建 address/templatetags 目录 


注意 ， 这 个 目录 要 在 某 个 应 用 的 下 面 ， 同 时 它 应 与 models, views.py 在 同一 层 目 录 下 。 


3 创建 address/templatetags/init.py 文件 


文件 为 空 即 可 。 


4 创建 自 定义 模板 文件 
address/templatetags/change_gender.py 


文件 名 为 你 想 要 装 入 到 模板 中 的 名 字 。 如 文件 起 名 为 change_gender.py ， 那 么 你 将 可 以 在 模 
板 中 使 用 : 


{% load change_gender %} 


来 导入 。 


5 编辑 change_gender.py 


from django import template 
register = template.Library() 


@register.filter(name='change_gender' ) 
def change_gender(value): 
if value == 'M': 
return ' 男 ' 
elise: 
return 'x' 


先是 导入 template 模块 ， 然 后 生成 一 个 register 的 对 象 ， 我 将 用 来 它 注 册 我 所 定义 的 filter。 
我 实现 的 filter 将 命名 为 "change_gender" ， 它 没有 参数 (一 个 filter 可 以 接受 一 个 参数 ， 或 没有 
参数 )。 当 value 为 M 时 返回 5 > $ value 为 F 时 返回 女 。 然 后 调用 register 的 filter Riz 
册 它 。 这 里 有 两 种 写法 ， 一 种 是 使 用 Python 2.4 才 支持 的 decorator (此 行 注 释 掉 了 )， 另 一 种 
是 使 用 标准 的 写法 。 在 使 用 decorator 时 ， 如 果 filter 方法 有 多 个 参数 的 话 ， 需 要 指明 name 
参数 ， 否 则 可 以 直接 写 为 : 


@register.filter 


它 自动 将 函数 名 认为 是 filter 的 名 字 。 


6 修改 templates/address/list.html 


{% extends "base.html" %} 

{% block content %} 

{% load change_gender %} 

<style type="text/css"> 

hi#title {color:white;} 

.mytr1i {background:#D9F9D0} 

.mytr2 {background:#CiF8BA} 

.myth {background: #003333} 

.th_text {color:#ffffff} 

</style> 

<div id="header"> 

<h1 id="tit1le"> 通 讯 录 </h1> 

</div> 

<hr> 

<div id="content-main"> 

<table border="0" width="500"> 
<tr align="right"> 
<td>{% if has_previous %} 

<a href="/address?page={{ previous }}"> 上 一 页 </a> 
{% endif %} {% if has_next %} 
<a href="/address?page={{ next }}">F—W</a> 
{% endif %}</td></tr> 


</table> 

<table border="0" width="500" cellspacing="2"> 

<tr class="myth"> 
<th><span class="th_text">#k4</span></th> 
<th><span class="th_text">#4]</span></th> 
<th><span class="th_text">%1&@</span></th> 
<th><span class="th_text">+#i</span></th> 
<th><span class="th_text">l4]</span></th> 

</tr> 

{% for person in object_list %} 

<tr class="{% cycle 'mytri' 'mytr2' %}"> 
<td>{{ person.name }}</td> 
<td>{{ person.gender|change_gender }}</td> 
<td>{{ person.telphone }}</td> 
<td>{{ person.mobile }}</td> 
<td>{{ person.room }}</td> 

</tr> 

{% endfor %} 

</table> 

<table border="0" width="500"> 

<tr> 

<td> 

<form enctype="multipart/form-data" method="POST" action="/address/upload/"> 

文件 导入 : <input type="file" name="file"/><br/> 

<input type="submit" Value=" 上 传 文件 "/> 

</form> 

</td> 

<td><p><a href="/address/output/">4 i AcsvXt#</a></p></td> 

</tr> 

</table> 

</div> 
{% endblock %} 


改动 了 以 下 几 个 地 方 : 
1. 增加 了 {% load change_gender %} 来 导入 自 定 义 的 filter 。 
2. 增加 了 几 个 样式 7 象 mytri ， mytr2 等 2 


3. 显示 结果 的 table KRHA: 


<table border="0" width="500" cellspacing="2"> 


1， 表 头 改 为 : 


第 十 讲 扩展 django 的 模板 


<tr class="myth"> 
<th><span class="th_text">#4</span></th> 
<th><span class="th_text">l£ 4]</span></th> 
<th><span class="th_text">%1&</span></th> 
<th><span class="th_text">##u</span></th> 
<th><span class="th_text"> l]</span></th> 
AS 


增加 了 样式 处 理 


1. 数据 显示 的 tf 标签 改 为 : 


<tr class="{% cycle 'mytri' 'mytr2' %}"> 


使 用 了 cycle Tag 来 处 理 表格 行 的 样式 切换 。 注 意 : cycle 处 理 的 是 字符 串 。 


1. 修改 {{ person.gender }} A {{ person.gender|change_gender }} 


Ba server 进行 测试 


注意 ， 一 定 要 重启 。 象 templatetags 之 类 是 在 导入 时 处 理 的 ， 因 此 如 果 server 已 经 启动 
再 添加 的 话 是 不 起 作用 的 。 其 它 象 增 加 app, 修改 settings.py 都 是 要 重启 ， 而 修改 
urls.py , view, model 人 代码， 模板 什么 的 可 以 不 用 重启 ， 在 必要 时 Django 的 测试 web 
server 会 自动 重启 。 如 果 你 使 用 Apache 的 话 ， 估 计 绝 大 多 数 情况 下 要 重启 ， 可 能 只 有 
修改 模板 不 用 吧 。 不 过 也 仍然 可 以 设置 Apache 以 便 让 每 次 请 求 过 来 时 重新 装 入 Python 
模块 。 
如 果 一 切 成 功 ， 你 会 看 到 M, F 都 改过 来 了 。 这 里 如 果 你 感 兴 趣 还 可 以 改 成 小 图 标 来 表示 ， 点 
级 一 下 。 


效果 画面 为 : 
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Django Step by Step (十 一 ) 


1 引言 


让 我 们 再 仔细 看 一 下 这 个 通讯 录 ， 我 们 知道 ， 如 果 想 增加 新 的 记录 ， 一 种 方法 是 通过 admin 

， 这 个 已 经 由 Django 自动 为 我 们 做 好 了 。 我 们 还 可 以 批量 导入 ， 这 个 是 我 们 实现 的 。 但 
这 里 有 风险 ， 为 什么 ?如 果 什 么 人 都 可 以 导入 这 可 是 件 不 好 的 事 ， 那 么 怎么 办 : 加 权限 控 

o 


Django 自 带 了 一 个 权限 控制 系统 ， 那 么 我 们 就 用 它 。 因 此 先 让 我 们 简单 地 了 解 一 下 Django 
中 的 权限 。 ee o A 者 ， 在 前 几 讲 中 我 们 一 直 使 用 超级 
用 户 ， 但 这 并 不 是 个 好 的 习惯 。 因 此 让 我 们 先 创建 个 个 人 用 户 吧 。 


2 添加 一 个 个 人 用 户 


使 用 admin 用 户 进 入 管理 界面 http://localhost:8000/admin 
在 Auth 下 有 用 户 一 项 ， 点 击 添加 按钮 进入 添加 界面 ， 还手 复杂 的 。 在 这 里 提示 是 黑体 的 字段 


是 必 输 项 ， 其 实 只 有 两 项 是 需要 我 们 输 的 : 用 户 名 和 密码 。 用 户 名 好 办 ， 密 码 有 一 些 复杂 度 
的 要 求 : 





增加 用 户 

首先 ， 输 入 一 个 用 户 名 和 客人 咎 。 然 后 ， 你 就 可 以 编辑 更 多 的 用 户 选 项 。 
用 户 名 : 日 
密码 : (8) 
密码 确认 : (8) 


e 你 的 密码 不 能 与 其 他 个 人 信息 太 相 似 。 


第 十 一 讲 用 户 管理 


A ele eens 
你 的 密码 不 能 是 大 家 都 爱 用 的 常见 密码 。 
你 的 密码 不 能 全 部 为 数字 。 


知道 了 密码 的 要 求 之 后 ， 那 么 我 们 只 要 填 入 用 户 名 ， 密 码 就 行 了 。 


图 有 效 
指明 用 户 是 否 被 认为 活跃 的 。 以 反选 代 营 删 除 帐 号 。 





























职员 状态 
措 明 用 户 是 否 可 以 登录 到 这 个 管理 站 点 。 
© 超级 用 户 状态 
SALEM RSENS. 
组 : 
可 用 组 @ EE + 
Q | wie | 
z] 
© 
© 
G 删除 人 
2% © 
该 用 户 归 必 的 组 。 一 个 用 户 将 得 到 其 月 层 的 组 约 所 有 权限 。 按 住 "Control"， 或 者 Mac 上 的 "Command"， 可 以 选择 多 个 , 
用 户 权限 : 
可 用 用 户 权限 @ 选中 的 用 户 权限 @ 
Q | ie 


| address | address 1 Can add address 
address | address | Can change address 
address | address | Can delete address 
admin | 日 志 记 录 | Can add log entry 
admin | 日 志 记 录 | Can change log entry 
admin | 日 志 记 录 | Can delete log entry 
auth | 8 | Can add group 
auth | #8 | Can change group 
auth | #8 | Can delete group 
auth | {RFR | Can add permission 

”auth | 权限 | Can change permission O HRS 

auth 14095 I Can delete nermission 了 


全 选 B 
为 该 用 户 声明 权限 。 按 住 "Controlj"， 或 者 Mac 上 的 “Command”, BLESS. 


| 
Oo0 














和 注意， 职员 状态 检查 框 如 果 不 打 勾 ， 则 你 的 用 户 也 无 法 使 用 ， 因 为 他 不 能 登录 。 也 许 你 
担心 ， 如 果 打 多 了 ， 那 不 是 他 就 能 做 好 多 事 了 吗 ? 其 实 不 然 。 在 Django 中 ， 创 建 一 个 
ape eRe IN 人 
菜 个 用 户 的 。 因 此 如 果 管 理 员 不 给 菜 个 用 户 关于 app 的 使 用 权限 ， 那 么 这 个 用 户 根本 没 
有 办 法 操纵 这 些 app ， 甚 至 连 看 都 看 不 到 (大 家 自己 试 一 下 就 知道 了 )。 这 样 他 能 够 做 的 

只 是 登录 ， 但 这 也 许 就 够 了 ， 有 时 我 们 需要 的 就 是 一 个 用 户 的 合法 身份 ， 而 不 是 一 定 要 
他 能 做 些 什么 
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request 对 象 提 供 一 个 user 对 象 ， 你 可 以 根据 它 来 判 断 当 前 用 户 的 身份 ， 所 属 的 组 ， 所 拥 
有 的 权限 。 我 们 可 以 在 view 代码 中 进行 用 户 身份 的 检查 。 


现在 我 的 想法 是 : 限制 特殊 用 户 来 做 这 件 事 。 首 先 我 可 以 在 settings.py 中 设 定 这 个 用 户 
名 ， 然 后 在 view 中 检查 当前 用 户 是 否 是 settings.py 中 设 定 的 用 户 S 


3 修改 newtest/settings.py 
在 最 后 增加 : 


UPLOAD_USER = '1limodou' 


= 


这 里 请 把 limodou 改 成 你 想 要 的 名 字 。 要 注意 ， 在 后 面 的 测试 中 你 需要 按 这 里 指定 的 名 
字 创 建 一 个 用 户 。 


4 修改 address/views.py 


from django.conf import settings 


@csrf_exempt 
def upload(request): 
if request.user.username != settings.UPLOAD_USER: 
return render_to_response('address/error.html', 
{'message':' 你 需要 使 用 %s 来 登录 ! ' % settings.UPLOAD_USER}) 


我 们 从 django.conf 导出 了 settings ， 然 后 在 upload() 中 判断 当前 用 户 名 是 否 是 等 于 
settings.UPLOAD_USER 这 个 用 户 名 ， 如 果 不 是 则 提示 出 错 信息 。 否 则 继续 处 理 。 


好 象 一 切 都 挺 简单 ， 但 这 里 还 有 一 个 大 问题 : 能 不 能 自动 导向 一 个 用 户 注 册 的 页 面 去 呢 ? 上 
面 的 处 理 是 需要 用 户 进 入 admin 管理 界面 进行 注册 后 ， 再 进行 操作 。 如 果 没 有 注册 就 上 传 文 
件 ， 则 只 会 报错 。 这 里 我 希望 实现 : 如 果 用 户 没 有 注册 过 ， 自 动 显示 一 个 注册 页 面 。 如 何 做 
呢 ? 


文档 中 提出 了 一 个 方法 : 
from django.contrib.auth.decorators import login_required 


@login_required 
def my_view(request): 


这 个 方法 我 试 过 了 ， 但 失败 了 。 主 要 的 原因 是 : 如 果 你 还 没有 注册 ， 它 会 自动 导向 
/accounts/login/ ， 而 这 个 URL 目 前 是 不 存在 的 。 在 我 分 析 了 login.py 代码 之 后 ， 我 认为 它 只 
是 一 个 框架 ， 并 不 存在 Django 已 经 提供 好 的 模板 可 以 直接 使 用 ， 如 果 要 使 用 它 是 不 是 需要 我 
自己 去 建 一 个 可 以 用 的 模板 ? 没 办 法 ， 我 分 析 了 admin 的 代码 之 后 ， 最 终 找 到 了 一 种 替代 的 
方法 : 


from django.contrib.admin.views.decorators import staff_member_required 
@staff_member_required 


def upload(request): 


admin 已 经 提供 了 这 样 的 一 个 方法 : staff_member_required 。 它 允许 我 使 用 admin 的 登录 
画面 。 


一 旦 把 上 面 的 代码 补充 完整 ， 代 码 是 这 样 的 : 


from .models import Address 


from django.http import HttpResponseRedirect 

from django.shortcuts import render_to_response 

from django.views.decorators.csrf import csrf_exempt 
from django.conf import settings 





from django.contrib.admin.views.decorators import staff_member_required 


@staff_member_required 
@csrf_exempt 
def upload(request): 
if request.user.username != settings.UPLOAD_USER: 
return render_to_response('address/error.html', 
{'message':' 你 需要 使 用 %s 来 登录 ! ' % settings.UPLOAD_USER}) 
file obj = request.FILES.get('file', None) 
if file_obj: 
import csv 
from io import StringIO 


ERYS 
csvfile = StringI0(file_obj.read().decode()) 
reader = csv.reader(csvfile) 

except: 


return render_to_response('address/error.html', 
{'message':' 你 需要 上 传 一 个 csv 格 式 的 文件 1 '}) 
for row in reader: 
objs = Address.objects. filter (name=row[0] ) 
if not objs: 
obj = Address(name=row[0], gender=row[1], 
telphone=row[2], mobile=row[3], room=row[4]) 
elise: 
obj = objs[0] 
obj.gender = row[1] 
obj.telphone = row[2] 


obj.mobile = row[3] 
obj.room = row[4] 
obj .save() 


return HttpResponseRedirect('/address/' ) 
else: 
return render_to_response('address/error.html', 
{'message':' 你 需要 上 传 一 个 文件 1 '}) 


from django.http import HttpResponse 
from django.template import loader, Context 


def output(request): 
response = HttpResponse(content_type='text/csv') 
response['Content-Disposition'] = ‘attachment; filename=%s' % 'address.csv' 
t = loader.get_template('address/csv.html') 
objs = Address.objects.all() 


ga 1 
for o in objs: 
d.append((o.name, o.gender, o.telphone, o.mobile, o.room)) 
c = {'data': d,} 
response.write(t.render(c) ) 
return response 


基本 没有 变化 ， 主 要 是 开始 的 一 些 地 方 增加 了 用 户 权限 的 处 理 。 


5 È a server 测试 


在 点 击 上 传 之 后 ， 如 果 没 有 注册 会 进入 登录 画面 。 如 果 已 经 注册 ， 但 用 户 名 不 对 ， 则 提示 一 
个 出 错 信息 。 不 过 ， 一 旦 注册 出 错 ， 没 有 提供 自动 重新 登录 的 功能 ， 因 此 你 需要 进入 admin 
管理 地 址 ， 然 后 注销 当前 用 户 ， 再 重新 上 传 或 先 用 正确 的 用 户 登录 。 因 为 是 个 简单 的 app ， 
没 必要 做 得 那么 完善 。 同 时 还 存在 的 一 个 问题 是 ， 如 果 你 没有 注册 过 ， 那 么 点 击 上 传 按钮 
后 ， 将 进入 登录 画面 ， 但 如 果 成 功 ， 你 上 传 的 文件 将 失效 ， 需 要 重新 再 上 传 。 那 么 解决 这 
问题 的 一 个 好 方法 就 是 : 不 要 直接 显示 上 传 的 东西 ， 而 是 先 提供 一 个 链接 或 按钮 ， 认 证 通过 
后 ， 再 提供 上 传 的 页 面 ， 这 样 可 能 更 好 一 些 。 


个 


在 User authentication in Django 文档 中 还 有 许多 的 内 容 ， 如 权限 ， 在 模板 中 如 何 使 用 与 认证 
相关 的 变量 ， 用 户 消 息 等 内 容 。 


Django Step by Step (t>) 


wh 


1 引 


如 果 通 讯 录 中 的 记录 很 多 ， 我 希望 有 一 种 搜索 的 方法 ， 下 面 就 让 我 们 加 一 个 搜索 功能 吧 。 当 
然 ， 这 个 搜索 功能 是 很 简单 的 。 在 Django 邮件 列表 中 看 到 WorldOnline( 好 象 是 它 ) 有 一 个 搜 
索 的 框架 ， 可 以 定义 哪些 模块 的 哪些 字段 要 参加 搜索 。 这 样 在 处 理 时 会 自动 将 相应 的 信息 加 
入 到 搜索 数据 库 中 进行 预 处 理 。 现 在 这 个 框架 并 没有 开放 源码 ， 而 且 它 底层 使 用 的 搜索 的 东 
西 并 不 是 Django 本 身 的 。 这 里 我 只 是 对 姓名 字段 进行 查找 。 


2 修改 templates/address/list.html 


[ss] 
<hr> 
<div id="content-main"> 
<table border="0" width="500"> 
<tr align="right"><td> 
<form method="GET" action="/address/search/"> 
搜索 姓名 : <input name="search" type="text" value="{{ searchvalue }}"/> 
<input type="submit" Value=" 提 交 "/> 
</form> 
</td></tr> 
</table> 
<table border="0" width="500"> 
<tr align="right"> 
<td>{% if has_previous %} 


ee | 


在 显示 分 页 的 代码 上 面 增 加 了 搜索 的 处 理 。 


从 上 面 可 以 看 到 ， 条 件 输入 处 我 增加 了 一 个 searchvalue 的 变量 ， 希望 在 提交 一 个 搜索 后 
显示 页 面 的 同时 显示 当前 显示 时 使 用 的 条 件 。 


由 于 搜索 结果 页 面 也 是 一 个 列表 页 面 ， 我 们 希望 能 够 用 第 九 讲 介绍 过 的 generic view 来 显示 
结果 ， 因 为 列表 页 面 的 处 理 非常 简单 : 


class IndexView(generic.ListView): 
model = Address 
template_name = ‘address/list.html' 
paginate_by = 2 


但 是 这 里 存在 一 个 困难 : 如 何 把 搜索 条 件 ， 搜 索 字 符 串 与 generic view 相关 联 呢 ? 通过 
urls.py 我 想 是 不 行 的 ， 因 为 它 只 从 url 解析 ， 而 且 对 于 QUERY_STRING 是 不 进行 解析 的 
(QUERY_STRING 是 指 : http://example.com/add/?name=test 中 ? 后 面 的 东西 ， 也 就 是 
name=test )。 对 于 搜索 条 件 ， 我 会 使 用 一 个 form 来 处 理 ， method 会 设 为 GET ， 因 此 生 
成 的 url 中 ， 查 询 条 件 正 如 这 个 例子 ， 如 : http://localhost :8000/address/search/? 
search=limodou 。 这样 无 法 变 成 上 面 所 要 用 到 的 参数 。 


这 里 我 们 需要 对 generic view 进 行 一 下 扩充 ， 我 们 需要 实 
现 get_queryset 和 get_context_data 这 两 个 方法 。 分 别 用 来 指定 结果 集 和 模板 演 染 的 参数 ， 
我 们 先 来 看 看 新 的 view 方 法 怎么 写 : 


3 修改 address/views.py 


class SearchView(generic.ListView): 


template_name = 'address/list.html' 
paginate_by = 2 


def get_queryset(self): 
if self.request.GET.get('search'): 
self.name = self.request.GET['search'] 
return Address.objects.filter(name = self.name) 
elise: 
self.name = None 
return Address.objects.all() 


def get_context_data(self, **kwargs): 
context = super().get_context_data(**kwargs) 
if self.name: 
context['searchvalue'] = self.name 
return context 


我 们 使 用 get_queryset 方法 代替 了 model = Address ， 这 样 可 以 更 加 灵活 的 定义 返回 的 结果 
集 。 
我 们 使 用 get_context_data 指定 了 可 以 传 入 到 模板 中 的 上 下 文字 典 


self.request.GET['search'] 从 GET 中 得 到 数据 ， 是 一 个 方便 的 用 法 。 它 将 得 到 提交 的 查询 
姓名 条 件 ， 如 果 有 这 个 参数 ， 那 么 我 们 使 用 filter 函数 对 结果 进行 过 滤 。 如 果 没 有 提交 ， 则 
显示 全 部 数据 。 


4 修改 address/urls.py 


urlpatterns = [ 
url(r'Aadmin/', admin.site.urls), 
url(r'4$', helloworld.index), 
url(r'^add/$', add.index), 
url(r'Alist/$', list.index), 
url(r'Axls/(?P<filename>\w+)/$', xls_test.output), 
url(r'Alogin/$', login.login), 
url(r'Alogout/$', login.logout), 
url(r'Awiki/', include('wiki.urls')), 
url(r'\address/', include('address.urls')), 

] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) 


增加 了 一 个 search 的 url 链接 映射 。 


5 È 3 server 测试 


感觉 这 个 通讯 录 也 差不多 了 ， 现 在 让 我 们 将 其 部 署 到 Apache 上 去 跑 一 跑 吧 。 
但 部 署 到 apache 时 才 知 道 ， 问 题 很 多 啊 。 主 要 问题 如 下 : 
© CentOS 7 服务 器 默认 自 带 的 Python 版 本 太 低 
CentOS 7 自 带 的 Python 版 本 为 Python2.7， 我 们 希望 能 够 使 用 最 新 的 Python 3.6 
o 相对 路 径 的 问题 


许多 使 用 相对 路 径 的 地 方 都 不 对 了 。 必 须 使 用 绝对 路 径 。 不 过 这 一 点 对 于 部 署 来 说 的 确 
有 些 麻 烦 ， 好 在 要 改动 的 地 方 不 多 ， 主 要 在 settings.py 中 。 如 数据 库 名 字 (sqlite3)， 模 板 
的 位 置 。 


其 它 的 就 是 要 注意 的 地 方 了 。 


6 部 署 到 Apache 上 的 体验 


只 能 说 是 体验 了 ， 因 为 我 不 是 Apache 的 专家 ， 也 不 是 mod_wsgi 的 专家 ， 因 此 下 面 的 内 容 
只 能 算是 我 个 人 的 配置 记录 ， 硕 望 对 大 家 有 所 帮助 。 


6.1 JRA %2% Python 3.6 


下 面 的 操作 我 们 都 假定 环境 是 CentOS 7 的 环境 ， 您 可 以 在 阿里 云 、 腾 讯 云 等 公有 云 服务 商 购 
买 ECS 服 务 器 ， 会 自动 给 你 安装 好 相应 的 操作 系统 ， 最 后 给 你 一 个 root 的 用 户 名 和 密码 。 


使 用 你 自己 熟悉 的 SSH 环 境 ， 用 root 用 户 登 录 即 可 ， 首 先 安装 Python 3.6， 执 行 下 面 的 命令 。 


yum install -y python36 

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py 
python36 get-pip.py 

pip install virtualenv 


这 样 的 话 你 安装 的 pip 会 默认 使 用 Python3.6， 我 们 顺手 安装 好 了 virtualenv 环 境 。 操 作 系统 的 
Python 环境 不 要 安装 太 多 的 库 文 件 ， 都 放 到 自己 应 用 的 venv 环 境 中 ， 创 建 一 个 虚拟 的 环境 。 
6.2 安装 mod_wsgi 模块 


mod_wsgi 的 安装 有 很 多 种 方法 ， 这 里 介绍 的 是 官方 推荐 的 办 法 ， 使 用 pip 安 装 ， 首 先 需要 安装 
http 的 开发 包 ， 然 后 使 用 pip 安 装 mod_wsgi 到 系统 的 lib 库 中 ， 执 行 下 面 的 命令 。 


yum install -y http-devel python36-devel 
pip install mod_wsgi 


然后 我 们 需要 将 mod_wsgi 安 装 到 apache 服 务 器 module 中 去 。 


cd /etc/httpd/modules 
ln -s /usr/1ib64/python3.6/site-packages/mod_wsgi/server/mod_wsgi-py36.cpython-36m- x86 
_64-linux-gnu.so mod_wsgi.so 


我 们 通过 在 /etc/httpd/modules 下 面 创建 符号 链接 的 方式 ， 让 apache 在 启动 的 时 候 自动 加 载 
mod_ wsgi.so ° 


然后 我 们 需要 在 /etc/httpd/conf.modules.d 中 创建 一 个 文件 ， 加 载 mod wsgi.so， 使 用 vi 
/etc/httpd/conf.modules.d/10-wsgi.conf 命令 创建 配置 文件 ， 然 后 录入 下 面 的 内 容 : 


LoadModule wsgi module modules/mod_wsgi.so 
之 后 使 用 systemctl restart httpd 重启 apache 服 务 即 可 2 


6.2 创建 配置 文件 


假定 我 们 的 django 工 程 在 /var/www/proc/newtest， 那 么 我 们 应 该 创 
建 /etc/httpd/conf .d/wsgi.conf 


WSGIScriptAlias /newtest /var/www/proc/newtest/newtest/wsgi.py process-group=newtest 
WSGIPythonHome /var/www/proc/newtest/venv 
WSGIPythonPath /var/www/proc/newtest 


<Directory /var/www/proc/newtest/newtest> 
<Files wsgi.py> 
Require all granted 
</Files> 
</Directory> 


> 


#Deamon 模 式 设置 

WSGIDaemonProcess newtest python-home=/var/www/proc/newtest/venv python-path=/var/www/ 
proc/newtest 

WSGIProcessGroup newtest 


PALI 


Alias /newtest/robots.txt /var/www/proc/newtest/static/robots.txt 
Alias /newtest/favicon.ico /var/www/proc/newtest/static/favicon.ico 


Alias /newtest/media/ /var/www/proc/newtest/media/ 
Alias /newtest/static/ /var/www/proc/newtest/static/ 


<Directory /var/www/proc/newtest/static> 
Require all granted 

</Directory> 

<Directory /var/www/proc/newtest/media> 


Require all granted 
</Directory> 


WSGIPythonHome 是 Python 运行 环境 的 绝对 路 径 ， 这 里 指向 我 们 virtualenv 的 目录 


这 里 我 还 设 了 两 个 别名 ， 用 来 指向 media 和 static 目录 。 在 media 和 static 的 
Location 中 设置 不 进行 脚本 的 解析 。 


上 面 的 media 路 径 是 指向 Django 在 Python 上 的 安装 目录 。 你 完全 可 以 将 其 拷贝 出 来 ， 
这 样 可 能 要 方便 得 多 。 另 外 在 linux 下 使 用 In 也 相当 的 方便 。 

6.3 测试 

http://localhost:8888/address 


更 详细 的 内 容 请 参见 mod_wsgi 文档 。 关 于 admin 的 media 和 template 好 象 并 不 需要 配 
置 ， 大 家 有 什么 结果 可 以 告诉 我 。 


同时 如 果 你 不 想 每 次 重启 Apache 来 进行 测试 ， 可 以 将 : 


MaxRequestsPerChild 0 


改 为 : 


MaxRequestsPerChild 1 


7 Ja té 


上 面 的 步骤 是 直接 把 开发 的 东西 发 布 到 了 Apache 中 去 ， 但 实际 中 开发 与 运行 可 能 环境 根本 
不 一 样 ， 最 主要 可 能 就 是 数据 库 方面 的 变化 ， 如 果 model 变 化 ， 则 有 可 能 要 编写 数据 切换 程 
序 。 许 多 实际 的 问题 都 需要 仔细 地 考虑 。 


Django Step by Step (十 三 ) 


1 引言 


经 过 一 段 时 间 的 学 习 ， 我 想 大 家 对 于 Django 的 一 些 基础 的 东西 已 经 有 所 了 解 ， 但 Django 本 
身 的 内 容 不 仅仅 如 此 ， 它 还 在 发 展 中 ， 还 有 许多 的 专题 是 我 还 没有 向 大 家 介绍 的 。 因 此 ， 随 
着 我 和 大 家 一 同 地 学 习 ， 我 会 继续 向 大 家 介绍 一 些 更 高 级 的 话题 。 


随 着 对 于 web 的 了 解 越 来 越 多 ， 我 对 于 web 上 的 开发 也 越 来 越 有 兴趣 。 的 确 ， 在 实际 的 工作 
中 我 也 发 现 ， 现 在 越 来 越 强调 团队 的 管理 ， 许 多 事情 单纯 搞 一 两 个 人 是 很 困难 的 ， 因 此 如 何 
提高 团队 工作 的 一 致 性 和 方便 性 越 来 越 重要 ， 比 如 : 在 我 所 在 的 项 目 组 ， 有 一 些 统计 信息 需 
要 每 个 人 提供 ， 然 后 进行 汇总 。 目 前 还 是 采用 手工 的 方式 ， 这 种 方式 的 确 简单 ， 但 不 能 自动 
地 进行 管理 ， 也 不 利于 以 后 的 归档 处 理 。 因 此 我 很 希望 做 成 web 的 应 用 ， 让 每 个 人 可 以 自由 
创建 项 目 ， 提 交 数 据 。 但 就 是 这 样 的 一 个 简单 的 工作 ， 也 不 是 非常 简单 的 事情 。 如 何 快速 对 
Django 加 深 了 解 ， 如 何 提高 开发 效率 ， 如 何 更 有 效 地 利用 web 是 我 更 关心 的 ， 而 不 仅仅 是 做 
出 一 个 可 用 的 应 用 来 。 这 包括 一 系列 的 NewEdit 的 扩展 ， 及 其 关 知 识 的 积累 。 


特别 让 我 感 兴 趣 ， 并 且 可 以 极 大 的 提高 用 户 体验 的 一 种 web 技术 就 是 Ajax 了 。 它 是 什么 ? 它 
是 一 种 技术 的 总 称 ， 包 括 了 Html, CSS, XML, Javascript 等 与 web 相关 技术 的 合集 ， 在 我 以 
前 的 Blog 也 有 一 些 涉及 ， 但 那 时 关注 的 焦点 不 在 web 上 。 现 在 有 机 会 和 时 间 好 好 地 了 解 了 

一 下 ， 特 别 是 在 Django 中 已 经 做 为 实现 的 目标 正在 逐步 地 开展 起 来 ， 只 不 过 目前 还 没有 可 用 
的 东西 哇 现 出 来 。 那 么 在 Django 的 community 的 blog 上 ， 有 人 发 表 了 一 篇 关于 使 用 dojo 

(一 个 Ajax 的 库 ) 来 实现 在 搜索 栏 中 实时 输入 信息 时 ， 可 以 动态 显示 与 输入 信息 相 匹配 的 blog 

列表 的 一 个 例子 。 他 利用 dojo 实现 了 一 个 自 定义 的 widget ， 但 我 感到 这 种 技术 对 于 我 这 种 对 
于 dojo 框 架 不 熟悉 的 人 非常 有 困难 。 从 blog 上 看 ， 实 现 的 过 程 还 是 有 些 复杂 。 我 喜欢 先 从 简 
单 的 东西 入 手 。 Mochikit 在 Django 的 Ajax 的 讨论 中 是 另 一 个 为 大 家 关注 的 东西 ， 最 大 的 好 
处 是 它 的 文档 最 齐全 ， 而 且 从 本 人 的 理解 来 说 ， 它 更 简单 。 而 dojo 则 更 是 提供 了 很 多 的 web 
Ul 的 控件 ，MochiKit 基本 上 没有 。 不 过 ， 在 目前 情况 下 我 也 只 是 希望 体验 一 下 Ajax 技术 ， 

并 且 做 一 些 简 单 的 应 用 ， 而 在 简单 的 情况 下 ， 我 认为 MochiKit 做 为 入 门 ， 作 为 简单 的 应 用 也 
足够 了 。 


下 面 就 让 我 以 MochiKit 为 基础 来 向 大 家 介绍 一 下 如 何在 Django 中 使 用 它 ， 使 用 一 些 简单 的 
Ajax 技术 。 


首先 让 我 们 关心 一 下 Ajax 与 Django 的 关系 。 其 实 Ajax 本 身 包含 许多 的 内 容 ， 它 有 浏览 器 端 
的 显示 技术 ， 有 与 后 台 通 讯 的 处 理 ， 因 此 与 Django 有 关系 的 其 实 只 有 与 后 台 交 互 那 块 东西 。 
这 样 ， 更 多 的 关于 前 端 显示 的 技术 ， 如 : 显示 特效 ， 这 些 都 属于 CSS, Javascript 的 内 容 ， 而 
这 些 与 Python 本 身 的 关系 也 不 大 ， 因 此 你 还 需要 掌握 这 些 东西 才 可 以 做 得 更 好 。 也 许 有 机 会 
会 有 专题 和 学 习 和 介绍 这 些 方面 的 东西 。 


tn nts 与 后 端的 交互 ， es 览 器 与 Django 交互 ， 体 验 不 
页 面 的 刷新 (这 是 Ajax 最 大 的 好 处 ， 一 切 都 好 象 在 本 地 进行 一 样 ) 。 


就 目前 来 说 ，Ajax 与 后 台 交 互 都 是 通过 浏览 器 提供 的 xMLHttpRequest 对 象 来 实现 的 。 这 个 
对 象 支持 同步 和 异步 的 调用 ， 但 由 于 Javascript 本 身 没 有 多 线程 这 个 东西 ， 因 此 为 了 不 阻塞 
浏览 器 ， 一 般 都 采用 异步 方式 来 调用 ， 而 这 也 是 一 般 的 Ajax 框架 提供 了 默认 方式 。 就 目前 来 
说 ， 交互 数据 也 有 多 种 格式 ， 比 如 : XML, Json , 纯 文本 /Html。 XML 不 用 说 了 ， 但 一 般 采 用 
http 协议 的 web server 是 无 法 直接 支持 ， 因 此 需要 进行 转换 。 同 时 在 浏览 器 你 要 同时 进行 
XML 的 解析 ， 不 是 非常 方便 。 Json 是 一 种 数据 表示 格式 ， 它 非常 象 ay 的 数据 类 型 。 而 
且 它 只 有 数据 ， 没 有 任何 的 格式 ， 因 此 数据 传输 量 非常 小 。 再 加 上 处 理 起 来 也 很 方便 ， 在 传 
输 上 可 以 直接 转换 为 文本 ， 然 后 再 转换 成 不 同 语言 的 数据 结构 即 可 。 对 于 Python 是 非常 方 
便 。 再 有 就 是 文本 /Html 方 式 ， 一 种 是 自 定义 格式 ， 通 过 转化 为 文本 进行 处 理 ， 另 一 种 就 是 直 
接 使 用 html 标记 。 前 一 种 需要 自行 做 扩展 ， 后 一 种 则 是 最 方便 。 下 面 我 们 将 先 使 用 htm 方 
式 ， 然 后 再 使 用 Json 来 进行 试验 。 


我 设计 了 一 个 非常 简单 的 例子 : 提供 一 个 输入 框 ， 用 户 输入 文本 ， 然 后 点 提交 ， 直 接 在 下 面 
显示 后 台 返 回 的 结果 。 因 为 我 不 是 Javascript , CSS 的 专家 ， 可 能 有 不 对 的 地 方 。 


创建 Ajax 应 用 


manage.py startapp ajax 


3 修改 ajax/views.py 


# Create your views here. 


from django.http import HttpResponse 


def input(request): 
input = request.REQUEST["input"] 
return HttpResponse('<p>You input is "%s"</p>' % input) 


这 里 可 以 看 出 ， 我 需要 一 个 input 字段 ， 然 后 返回 一 个 HTML 的 片段 。 


4 创建 templates/ajax 目录 


创建 templates/ajax/ajax.html 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"http: //www.w3.org/TR/xhtmli/DTD/xhtmli-strict.dtd"> 
<html> 
<head> 
<title>Ajax Test</title> 
<script type="text/javascript" src="/site_media/Mochikit .js"></script> 
<script type="text/javascript" src="/site_media/ajax_test.js"></script> 
</head> 
<body> 
<hi> 
Ajax 演示 
</h1> 
<div> 
<form id="form"> 
输入 : <input type="text" name="input"/> 
<input id="submit" type="button" value=" 提 交 " /> 
</form> 
</div> 
<div id="output"></div> 
</body> 
</html> 


这 个 模板 将 作为 初始 页 面 ， 它 用 来 处 理 向 后 台 发 起 请 求 。 在 这 里 它 没有 需要 特殊 处 理 的 模板 
变 只 需要 显示 即 可 。 但 在 这 里 的 确 有 许多 要 说 明 的 东西 。 


- 


变量 


这 是 一 个 标准 的 html 的 页 面 ， 在 head 标签 中 ， 它 将 引入 两 个 js 文件 : MochiKit.js 和 
ajax_testjs ° M ur 上 可 以 看 出 ， 我 将 会 把 它们 放 在 site_media 下 ， 这 个 地 址 就 是 media A 
录 。 MochiKitjs 你 需要 从 Mochikit 网 站 下 载 (最 新 版 本 为 1.2)。 Mochikit 下 载 后 有 两 种 格 
式 ， 一 种 是 单个 文件 ， 另 一 种 是 分 散 的 文件 。 我 这 里 使 用 的 是 单个 文件 。 


在 html 文件 中 有 一 个 form ， 它 的 id 是 form ， 我 将 用 它 来 查找 form 对 象 。 它 有 一 个 文本 输 
入 框 ， 还 有 一 个 按钮 ， 但 这 个 按钮 并 不 是 submit 按钮 。 这 里 有 许多 与 标准 的 form 不 一 样 的 
地 方 ， 没 有 action, 没有 method ， 而 且 没 有 submit 按钮 。 为 什么 要 这 样 ， 为 了 简单 ， 而 且 我 
发 现 这 是 Mochikit 的 开发 方式 。 以 前 写 HTML > CSS, Javascript 和 事件 之 类 的 处 理 ， 我 们 一 
般 可 能 会 写 在 一 起 ， 但 这 样 的 确 很 乱 。 在 学 习 了 一 段 MochiKit 之 后 ， 我 发 现 它 的 代码 分 离 做 
得 非常 棒 ， 而 这 也 是 目前 可 能 流行 的 做 法 。 它 会 在 独立 的 Javascript 中 编写 代码 ， 在 装载 页 
面 时 动态 地 查找 相应 的 元 素 ， 然 后 设置 元 素 的 一 些 属 性 ， 如 style ， 事 件 代码 等 。 而 在 Html 
文档 中 ， 你 看 到 的 元 素 中 一 般 就 只 有 id, class 等 内 容 。 这 样 的 好 处 可 以 使 得 处 理 为 以 后 重用 
及 优化 带 来 方便 ， 同 时 可 以 通过 编程 的 方式 实现 批量 的 处 理 ， 而 且 也 使 得 Html 页 面 更 简单 和 
清晰 。 因 为 我 要 使 用 Ajax AARLE E’ TERAK form 的 提交 机 制 ， 我 只 是 需要 用 
到 form 元 素 中 的 数据 而 已 ， 因 此 象 action, method 等 内 容 都 没有 用 。 id 是 必须 的 ， 我 需要 
根据 它 找到 我 想 要 处 理 的 元 素 对 象 。 


不 过 分 离 的 作法 是 你 的 文件 将 增多 ， 也 可 能 不 如 放 在 一 个 文件 中 便于 部 署 吧 。 这 是 一 个 
仁者 见 仁 ， 智 者 者 见 智 的 作法 o 


<div id="output"></div> 它 是 用 来 显示 结果 的 层 。 
整个 处 理 过 程 就 是 : 


在 装载 html 页 面 时 ， 会 对 按钮 进行 初始 化 处 理 ， 即 增加 一 个 onclick 的 事件 处 理 ， 它 将 完 
成 Ajax 的 请 求 及 结果 返回 后 的 处 理 。 然 后 用 户 在 页 面 显示 出 来 后 ， 可 以 输入 文本 ， 点 击 按钮 


后 ， 将 调用 onclick 方法 ， 然 后 提交 信息 到 Django > H Django 返回 信息 ， 再 由 Ajax 的 
deferred 对 象 ( 后 面 会 介绍 ) 调 用 显示 处 理 。 


6 创建 media/ajax_test.js 


function submit(){ 
var form = $("form"); 
var d = doSimpleXMLHttpRequest('/ajax/input/', form); 
d.addCallbacks(onSuccess, onFail); 


} 


onSuccess = function (data){ 
var output = $("output"); 
output.innerHTML = data.responseText; 
showElement (output); 

} 


onFail = function (data){ 
alert(data); 
} 


TUNCELON) INLE A 
var btn = $("submit"); 
btn.onclick = submit; 
var output = $("output"); 
hideElement (output); 

} 


addLoadEvent (init); 


这 里 有 许多 是 Mochikit 的 方法 。 

首先 让 我 们 看 addLoadEvent(init); 它 表 示 将 init() 元 数 加 到 onload 的 响应 事件 对 列 

中 。 浏 览 器 在 装载 完 一 个 页 面 后 ， 会 自动 调用 onload 事件 处 理 。 因 此 在 这 里 是 进行 初始 化 
的 最 好 的 地 方 。 

init() 方法 一 方面 完成 对 id 名 为 submit 的 按钮 onclick 处 理 函 数 的 绑 定 工作 ， 另 一 个 
是 将 id A output 的 元 素 隐藏 。 其 实 不 隐藏 也 无 所 谓 ， 因 为 它 本 来 就 是 空 的 ， 因 此 你 也 看 不 
到 东西 。 不 过 如 果 有 其 它 的 东西 这 样 的 处 理 却 也 不 错 。 

$O 是 Mochikit 提供 的 一 个 getElement() 函数 别名 ， 它 将 根据 元 素 的 id 来 得 到 某 个 对 
Go 


hideElement() 是 隐藏 某 个 元 素 。 想 要 显示 某 个 元 素 可 以 使 用 showElement() ° 


最 重要 的 工作 都 在 sumit) 这 个 函数 中 。 它 首先 得 到 id A form 的 对 象 ， 然 后 调用 
Mochikit sa doSimpleXxMLHttpRequest() 函数 提交 一 个 Ajax 请 求 到 后 台 。 第 一 个 参数 是 请 
求 的 url ， 第 二 个 如 果 有 的 话 ， 应 该 是 Query String ， 即 一 个 url 的 ? 后 面 的 东西 。 这 里 我 只 
是 将 form ae > doSimplexMLHttpRequest() 会 自动 调用 querystring) (也 是 MochiKit 的 
一 个 方法 ) 来 取得 form 中 的 字段 信息 。 比 如 你 输入 了 aaa ， 那 么 最 终 在 Django 你 会 看 到 
的 是 : 


/ajax/input/?input=aaa 


doSimpleXxMLHttpRequest() 会 返回 一 个 deferred 对 象 ， 它 是 一 个 延迟 执行 对 象 ， 在 执行 了 
doSimplexMLHttpRequest() 之 后 ， 结 果 可 能 当时 并 没有 返回 回来 ， 因 为 这 是 一 个 异步 调用 。 
因此 为 了 在 结果 回来 之 后 做 后 续 的 处 理 ， 我 还 需要 挂 接 两 个 异步 函数 ， 一 个 用 来 处 理 成 功 的 
情况 ， 一 个 是 用 来 处 理 失败 的 情况 。 d.addcallbacks(onSuccess, onFail); 就 是 做 这 件 事 的 。 


onsuccess() 在 deferred 正确 返回 后 会 被 调用 。 data 是 xMLHttpRequest 对 RAY? CH 
一 个 responseText 属性 可 以 使 用 。 这 里 因为 Django 返回 的 是 Htm 片段 ， 因 此 我 只 是 简单 
地 将 output 对 象 (用 于 显示 的 div 层 ) 的 内 容 进行 了 设置 。 然 后 调用 showElement() 来 将 层 显 
示 出 来 。 


onFail() 则 只 是 调用 alert() 显示 出 错 而 已 。 


这 里 有 许多 Javascript 和 Mochikit 的 东西 ， 如 果 大 家 不 了 解 则 需要 补 补 课 了 。 其 中 Mochikit 
的 内 容 在 它 自 带 的 例子 和 文档 中 可 以 查阅 ， 特 别 是 MochiKit 自 带 了 一 个 象 Python shell 一 样 
的 命令 行 解释 环境 可 以 进行 测试 ， 非 常 的 方便 。 有 具体 的 看 MochiKit 网 站 上 的 ScreenCast 可 

以 了 解 。 


7 修改 urls.py 
增加 两 行 : 


(r'Aajax/$', 'django.views.generic.simple.direct_to_template', 
{'template': 'ajax/ajax.html'}), 
(r'Aajax/input/$', 'newtest.ajax.views.input'), 


前 一 个 使 用 了 generic view 所 提供 的 direct_to_template() 方法 可 以 直接 显示 一 个 模板 。 后 
一 个 则 指向 了 views.index() 方法 ， 它 用 于 在 前 一 个 页 面 点 击 按钮 后 与 后 台 交 互 的 处 理 。 


8 安装 ajax 应 用 


修改 settings.py 


INSTALLED_APPS = ( 
"django.contrib.auth', 
"django.contrib.contenttypes', 
"django.contrib.sessions', 
"django.contrib.sites', 
"newtest.wiki', 
"newtest.address', 
"newtest.ajax', 
"django.contrib.admin', 


9 2a server 测试 


这 样 你 在 文本 框 中 输入 内 容 ， 点 击 提交 后 就 会 立即 在 文本 框 的 下 面 看 到 结果 ， 而 页 面 没有 刷 
新 ， 这 就 是 Ajax 就 直接 的 做 用 。 


Django Step by Step (十 四 ) 


wh 


1 引 


Ajax 因为 大 量 地 使 用 了 Javascript ， 而 调试 Javascript 的 确 不 是 件 容易 的 事 ， 在 这 方面 只 有 
不 停 地 测试 ， 还 要 靠 耐 心 。 而 且 Ajax 本 身 可 能 还 有 一 些 安全 方面 的 东西 需要 考虑 ， 但 这 些 话 
题 需要 你 自己 去 学 习 了 。 


在 试验 了 简单 的 Html 返回 片段 之 后 ， 让 我 们 再 体验 一 下 Json 的 应 用 吧 。 为 了 使 用 Json ， 
我 下 载 了 simplejson 模块 。 我 下 载 的 是 1.1 版 本 。 还 可 以 使 用 easy_install 来 安装 。 


如 何 使 用 simplejson 在 它 自 带 的 文档 有 示例 很 简单 ， 下 面 我 们 就 用 它 来 试验 Json 的 例子 。 


我 将 在 上 一 例 的 基础 之 上 ， 增 加 一 个 按钮 ， 这 个 按钮 点 击 后 ， 会 发 送 一 个 请 求 (不 带 Json 信 
息 )， 然 后 Django 会 返回 一 个 Json 格式 的 表格 数据 ， 分 为 头 和 体 两 部 分 。 然 后 前 端 动态 生成 
一 个 表格 显示 在 Output 层 中 。 


2 修改 ajax/views.py 


#coding=utf-8 
# Create your views here. 


from django.http import HttpResponse 


def input(request): 
input = request.REQUEST["input"] 
return HttpResponse('<p>You input is "%s"</p>' % input) 


def json(request): 
a = {'head':('Name', 'Telphone'), ‘body':[(u'#=', '1111'), (u'#@', '2222')]} 
import simplejson 
return HttpResponse(simplejson.dumps(a) ) 


由 于 使 用 了 汉字 ， 前 面 的 coding=utf-8 一 定 要 加 上 ° 


json() 是 新 加 的 方法 。a 是 一 个 字典 ， 它 会 被 封装 为 Json 的 格式 。 这 里 还 使 用 了 汉字 ， 但 
使 用 了 unicode 的 表示 。 我 发 现 simplejson 在 处 理 非 ascii 码 时 会 自动 转 为 unicode ， 但 不 
正确 ， 因 此 我 直接 使 用 了 unicode。 因 此 我 希望 浏览 器 可 以 根据 这 个 数据 生成 表格 。 


3 修改 templates/ajax/ajax.html 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"http: //www.w3.org/TR/xhtmli/DTD/xhtmli-strict.dtd"> 
<html> 
<head> 
<title>Ajax Test</title> 
<script type="text/javascript" src="/site_media/Mochikit.js"></script> 
<script type="text/javascript" src="/site_media/ajax_test.js"></script> 
</head> 
<body> 
<hi> 
Ajax 演示 
</h1> 
<div> 
<form id="form"> 
输入 :<input type="text" name="input"/> 
<input id="submit" type="button" value=" 2%" /> 
<input id="json" type="button" value="JSON# an" /> 
</form> 
</div> 
<div id="output"></div> 
</body> 
</html> 


这 里 只 是 增加 了 一 个 按钮 ，id 是 json 。 它 将 用 来 触发 Ajax 请 求 。 


4 修改 media/ajax_test.js 


function callJson(){ 
var d = loadJSONDoc('/ajax/json/'); 
d.addCallbacks(onSuccessJson, onFail); 


} 
row_display = function (row) { 

return TR(null, map(partial(TD, null), row)); 
} 


onSuccessJson = function (data){ 
var output = $("output"); 
table = TABLE({border:"1"}, THEAD(null, row_display(data.head)), 
TBODY(null, map(row_display, data.body))); 
replaceChildNodes(output, table); 
showElement (output); 


} 

function init() { 
var btn = $("submit"); 
btn.onclick = submit; 
var output = $("output"); 
hideElement (output); 
var btn = $("json"); 
btn.onclick = callJson; 


在 最 后 一 行 addLoadEvent (init); 前 加 入 上 面 的 内 容 。 对 于 id 为 json 的 按钮 的 事件 绑 定 方 
式 与 上 一 例 相 同 ， 都 是 在 init() 中 进行 的 。 在 callJson() 中 进行 实际 的 Json 调用 ， 这 次 
使 用 了 Mochikit 提供 的 loadJsoNpoc() 函数 ， 它 将 执行 一 个 url 请 求 ， 同 时 将 返回 结果 自动 
转化 为 Json 对 象 ° 一 旦 成 功 > 将 调用 onSuccessJson() 函数 。 在 这 里 将 动态 生成 一 个 表格 ? 


表格 的 显示 使 用 了 MochiKit 的 DOM 中 的 示例 的 方法 。 row display) 是 用 来 生成 一 行 
的 。 TBODY 中 使 用 map 来 处 理 数组 数据 。 在 Mochikit 中 有 许多 象 Python NBA KAA HA > 
因为 它 的 许多 概念 就 是 学 的 Python 。 replaceChildNodes() 是 用 来 将 生成 的 结果 替换 掉 
output 元 素 的 内 容 。 


5 修改 urls.py 


(r'Aajax/json/$', 'newtest.ajax.views.json'), 


增加 上 面 一 行 。 这 样 就 增加 了 一 个 Json 的 url 映射 。 


6 司 动 server 进行 测试 


这 里 两 个 演示 共用 了 output 层 作为 显示 的 对 象 ， 你 可 以 同时 试 一 试 两 个 例子 的 效果 。 


不 过 这 里 有 一 个 问题 : 只 有 返回 时 使 用 了 Json 。 的 确 是 ， 这 样 是 最 简单 处 理 的 情况 。 因 为 
Json 可 以 包装 为 字符 串 ， 这 样 不 用 在 底层 进行 特殊 处 理 。 如 果 请 求 也 是 Json 的 ， 需 要 设计 
一 种 调用 规则 ， 同 时 很 有 可 能 要 实现 MiddleWare 来 支持 。 在 Django 中 的 确 有 人 已 经 做 过 类 
似 的 工作 。 不 过 我 目前 没有 研究 得 那么 深 ， 因 此 只 要 可 以 处 理 返回 为 Json 的 情况 已 经 足够 
了 。 而 且 Django 也 正在 进行 Ajax 的 支持 工作 ， 不 过 可 能 是 以 dojo 为 基础 的 ， 让 我 们 拭 目 以 
待 吧 。 


Django Step by Step (十 五 ) 


1 引言 


在 Ajax 的 试验 中 ， 你 会 看 到 有 一 些 是 用 英文 的 。 下 面 就 让 我 们 学 习 如 何 将 应 用 改 为 支持 
i18n 处 理 的 吧 。 在 本 讲 中 我 会 讲述 我 实现 的 过 程 ， 同 时 对 一 些 问 题 进行 讨论 。Django 中 
i18n 的 实现 过 程 : 


1.1 在 程序 和 模板 中 定义 翻译 字符 串 


AR _() 将 要 翻译 的 字符 串 包 括 起 来 。 这 里 有 几 种 做 法 ， 一 种 是 什么 都 不 导 
， 这 样 就 使 用 缺 省 的 方式 ， 另 一 种 是 导入 Django 提供 的 翻译 函数 。 Django 提供 了 
人 翻译 函数 ， 特 别 可 以 用 在 动态 语言 的 切换 。 在 模板 中 分 几 种 情况 


可 以 使 用 {% trans %} 标签 。 它 用 来 翻译 一 句 话 ， 但 不 能 在 它 中 间 使 用 模板 变量 。 如果 是 大 
段 的 文本 ， 或 要 处 理 模板 变量 ， 可 以 使 用 {% blocktrans %}{% endblocktrans %} 来 处 理 。 
Django 还 支持 简单 的 Javascript 的 i18n 的 处 理 ， 但 有 兴趣 自己 去 看 吧 。 


1.2 生成 po 文件 
定义 好 翻译 串 之 后 使 用 bin/make-messages.py 来 生成 po 文件 。 


Django 支持 多 层次 的 处 理 。 比 如 在 整个 Django 的 源码 项 目 ， 在 某 一 个 工程 ， 在 某 一 个 应 

用 。 在 不 同 层次 去 实现 i18n 时 ， 需 要 在 不 同 的 层次 的 根 目 录 去 执行 make-messages.py ° 4 

么 可 以 将 make-messages. py 找 贝 到 相应 的 目录 去 执行 ， 特 别 是 在 你 的 工程 或 应 用 中 。 在 执行 

make-messasges.py 时 ， 需 要 你 预 先 创建 conf/locale 或 locale 目录 ， 而 make- 

messasges.py 是 不 会 自动 为 你 创建 的 。 那 么 conf/locale 多 用 在 源码 中 ， 象 Django 的 源码 

就 是 放 在 conf/locale 中 的 。 但 在 运行 时 ， 对 于 自己 的 项 目 和 应 用 却 是 从 locale 中 来 找 的 
。 因 此 还 是 建议 你 创建 locale 来 存放 po 文件 。 


第 一 次 执行 时 : 


make-messages.py -l zh_CN 


这 时 会 生成 locale/zh_CN/LC_MESSAGES/django.po 和 django.pot 两 个 文件 。 


然后 你 就 可 以 开始 翻译 了 。 翻译 完成 之 后 ， 首 先 要 执行 闪 目 -> 设置 ， 将 缺 省 的 参 Bk- ay 
主要 是 : 项 目 名 称 及 版 本 ， 团 队 ， 团 队 专用 电子 邮件 ， 字 符 集 (一 般 为 utf-8) 。 ho 
> poEdit 在 保存 时 会 报错 。 使 用 poEdit 的 一 个 好 处 是 ， 在 保存 时 它 会 自 0 


mo 文件 。 


以 后 再 更 新 时 : 


make-messasges.py -a 


如 果 已 经 有 多 个 语言 文件 ， 那 么 执行 时 会 同时 更 新 这 些 po 文件 。 


1.3 配置 


Django 有 一 系列 的 策略 来 实现 i18n 的 功能 。 基 本 上 分 为 静态 和 动态 。 


静态 是 指 在 settings.py 中 设置 LANGUAGE CODE 为 你 想 要 的 语言 。 那 么 这 里 要 注意 ， 中 文 的 
语言 编码 是 zh-cn ， 但 locale 目录 下 却 是 zh CN 。 这 是 为 什么 : 其 实 一 个 是 
language(zh-cn) ， 一 个 是 locale(zh_CN) > Æ Django 的 utils.translation.py 中 有 专门 的 
方法 可 以 进行 转换 。 因 此 在 Django 的 程序 中 使 用 的 是 language 的 形式 ， 在 目录 中 却 是 使 用 
locale 的 形式 。 一 旦 设 为 静态 ， 则 它 表示 是 全 局 性 质 的 ， 在 所 有 其 它 的 策略 失效 后 将 使 用 这 种 
策略 o 


而 动态 是 指 在 运行 中 对 于 不 同 的 用 户 ， 不 同 的 浏览 器 的 支持 的 语言 可 以 有 不 同 的 语言 翻译 文 
件 被 使 用 。 这 种 方式 需要 在 settings.py 中 安装 
django.middleware.locale.LocaleMiddleware 到 MIDDLEWARE_CLASSES 中 去 。 同 时 如 果 你 想 在 


实现 应 用 中 的 翻译 文件 被 使 用 ， 也 要 采用 这 种 方式 。 
在 一 个 请 求 发 送 到 Django 之 后 ， 如 果 安 装 了 LocaleMiddleware ， 它 会 采用 下 面 的 策略 : 


e 在 当前 用 户 的 session 中 查找 django_language 键 字 。 

© 如 果 没 有 找到 则 在 cookie 中 查找 叫 django_language 的 值 。 

e 如 果 没 有 找到 ， 则 查看 Accept-Language HTTP 头 。 这 个 头 是 由 浏览 器 发 送 给 服务 器 
的 。 

© 如 果 没 有 找到 ， 则 使 用 全 局 的 LANGUAGE_CODE 设置 。 


如 果 你 使 用 FireFox 可 以 在 Tools->Options->Advanced->Eidt Languages 设置 你 所 接受 的 语 
言 并 且 将 zh-cn 放 在 最 前 面 ° 


上 面 讲 述 得 还 是 有 些 粗 ， 建 议 你 好 好 阅读 i18n 的 文档 。 
国际 化 处 理 的 文档 请 参阅 : Internationalization 文档 


下 面 开始 我 们 的 试验 。 


2 修改 ajax/views.py 


#coding=utf-8 
# Create your views here. 
from django.http import HttpResponse 


def input(request): 
input = request.REQUEST["input"] 
return HttpResponse(_('<p>You input is "%s"</p>') % input) 


def json(request): 
a = {'head':(unicode(_('Name'), 'utf-8'), unicode(_('Telphone'), ‘utf-8')), 
Yoh CU = (Mes, Uae yi 
import simplejson 
return HttpResponse(simplejson.dumps(a) ) 


这 里 对 所 有 英文 都 使 用 _() 进行 了 封装 。 但 对 于 Json 方法 ， 这 里 我 使 用 
进行 了 转换 。 


unicode(_('Name'), '‘utf-8') 


3 修改 settings.py 
增加 ~LocaleMiddleware 


MIDDLEWARE_CLASSES = ( 
"django.contrib.sessions.middleware.SessionMiddleware', 
"django.middleware.locale.LocaleMiddleware', 
"django.middleware.common.CommonMiddleware', 
"django.middleware.doc.XViewMiddleware', 
"django.contrib.auth.middleware.AuthenticationMiddleware', 


这 里 在 文档 中 对 于 Localemiddleware 的 顺序 有 要 求 ， 要 求 排 在 sessionMiddleware 之 后 ， 但 
在 其 它 的 Middleware 之 前 。 


话 虽 如 此 ， 但 我 感觉 目前 顺序 影响 不 大 ， 也 许 只 是 个 人 感觉 吧 。 


4 创建 ajax/locale 目录 
5 4 Jl make-messasges.py 到 ajax 目录 下 


6 执行 make-messasges.py 


Cd ajax 
make-message.py -l zh_CN 


7 使 用 poEdit 翻译 django.po 文件 


按 上 面 说 的 先 更 新 pot 文件 ， 然 后 修改 缺 省 的 参数 ， 再 保存 。 


如 果 你 没有 poEdit， 或 不 在 Windows 平台 下 ， 那 么 只 好 自己 去 想 办 法 了 。 同 时 这 里 
make-message.py 还 需要 Windows 下 的 xgettext 工具 。 可 以 在 
http://code.djangoproject.com/wiki/Localization 找到 说 明 。 
这 里 我 没有 演示 模板 的 处 理 。 因 为 Ajax 所 用 到 的 模板 没有 放 在 ajax 目录 下 ， 而 是 放 在 
templates 目录 下 。 因 此 ， 如 果 想 支持 i18n 的 话 ， 目 录 的 布置 是 一 个 问题 。 所 以 不 再 试验 
T 6 


8 È Z) server 测试 


是 不 是 都 是 中 文 了 呢 ? 如 果 不 是 ， 看 一 看 是 否 浏览 器 没有 设置 成 接受 zh-cn ° 


Django Step by Step (十 六 ) 


wh 


Django 中 的 模板 系统 可 以 被 自由 扩展 ， 如 自 定义 filter, 自 定 义 Tag 等 。 其 中 filter 用 于 对 变量 
的 处 理 。 而 Tag 则 功能 强大 ， 几 乎 可 以 做 任何 事情 。 我 认为 Tag 的 好 处 有 非常 多 ， 比 如 : 


。 可 以 简单 化 代码 的 生成 。 一 个 Tag 相当 于 一 个 代码 片段 ， 把 重复 的 东西 做 成 Tag 可 以 避 
免 许 多 重复 的 工作 。 

© 可 以 用 来 组 合 不 同 的 应 用 。 将 一 个 应 用 的 展示 处 理 成 Tag 的 方式 ， 这 样 就 可 以 在 一 个 模 
板 中 组 合 不 同 的 应 用 展示 Tag， 而 且 修改 模板 也 相对 容易 。 


如 果 要 自 定 义 Tag， 那 么 要 了 解 Tag 的 处 理 过 程 。 在 Django 中 ，Tag 的 处 理 分 为 两 步 。 


1. 编译 。 即 把 Tag 编译 为 一 系列 的 django.template.Node 结 点 。 
2. i@ #(Render) °- 2 xt Node 调用 它们 的 render) 方法 ， 然 后 将 输出 结果 拼接 起 来 。 


因此 自 定义 一 个 Tag， 你 需要 针对 这 两 步 处 理 来 做 工作 。 


在 The Django template language: For Python programmers 文档 中 讲解 了 一 些 例子 。 大 家 可 
以 看 一 下 。 


那么 下 面 ， 我 将 实现 一 个 显示 日 历 的 自 定义 Tag 。 


2 下 载 HTMLCalendar 模块 并 安装 


不 想 全 部 自己 做 ， 因 此 找 了 一 个 现成 的 模块 。 去 HTMLCalender 的 主页 下 载 这 个 模块 。 


然后 解压 到 一 个 目录 下 ， 执 行 安装 : 


python setup.py install 


3 下载 HTMLTemplate 模块 并 安装 
然后 解压 到 一 个 目录 下 ， 执 行 安 装 : 


python setup.py install 


因为 上 面 的 HTMLCalender 需要 它 才 可 以 运行 。 去 HTMLCalender 主页 下 载 这 个 模块 。 


4 创建 my_alendar 应 用 


manage.py startapp my_calendar 


这 里 起 名 为 my_calendar 。 因 为 如 果 起 名 为 calendar 会 与 系统 的 calendar 模块 重 名 。 


5 创建 my_calendar/templatetags 目录 


cd my_calendar 
md templatetags 


在 Windows 下 是 md, 在 Linux FÆ mkdir ° 


6 创建 mycalendar/templatetags/_init.py 文件 
空 文件 即 可 
7 创建 


my_calendar/templatetags/my_calendar.py <= 


a 


from django import template 


register = template.Library() 


class Caler Node(template.Node): 
def (self): 
pass 
def render(self, context): 


return "Calendar" 


def do_calendar(parser, token): 
return CalendarNode() 


register.tag('calendar', do_calendar ) 


上 面 的 代码 只 是 一 个 空 架子 。 不 过 让 我 们 仔细 地 解释 一 下 : 


e register 4 Á Æ filter 一样， 它 将 用 来 注册 一 个 Tag 的 名 字 到 系统 中 去 。 


e CalendarNode 它 是 template .Node 的 一 个 子 类 。 每 个 Tag 都 需要 从 Node 派生 。 这 个 
类 可 以 只 有 render() 方法 ， 用 来 返回 处 理 后 的 文本 。 _init_() 可 能 是 有 用 的 ， 先 


预 留 。 

e render() 方法 接受 一 个 context 参数。 这 个 参数 就 是 在 执行 模板 的 泻 沫 时 由 View 传 
入 的 。 不 过 更 复杂 的 例子 是 你 可 以 修改 context ， 这 样 达到 注入 新 变量 的 目的 。 不 过 本 
例 没 有 演示 。 

e do_calendar() 是 一 个 由 模板 处 理 引 擎 在 发 现 一 个 Tag 的 名 字 之 后 ， 将 进行 调用 的 方 
法 。 那 么 我 们 的 Tag 可 能 在 模板 中 写 为 {% calendar 4} 。 这 个 方法 将 在 下 面 通过 注册 过 
程 与 一 个 名 字 相 对 应 ， 这 里 我 们 想 使 用 calendar ° 


它 接 受 两 个 参数 : 
o parser 这 是 模板 处 理 引擎 对 象 ， 我 们 没有 用 到 。 


o token 表示 Tag 的 原始 文本 。 如 果 在 模板 中 我 们 定义 Tag 为 {% calendar 2006 1 
%} ,那么 token 就 为 calendar 20061 。 因 此 你 需要 对 它 进 一 步 地 处 理 。 


它 将 返回 一 个 Node 的 实例 ， 在 本 例 中 就 是 calendarNode 实例 。 
© register.tag('calendar', do_calendar ) 用 来 注册 Tag 名 字 和 对 应 的 处 理 方法 。 


尽管 我 们 没有 对 calendar 所 带 的 参数 进行 处 理 ， 但 它 仍 然 可 以 显示 。 要 知道 我 们 还 没有 使 用 
HTMLCalender 模块 呢 。 


8 创建 templates/my_calendar 目录 


9 创建 templates/my_calendar/calendar.html 文 
件 


{% load my_calendar %} 
{% calendar 2006 1 %} 


10 修改 usls.py 


38 Jo F 4 url 配置 : 


(r'Acalendar/$', 'django.views.generic.simple.direct_to_template', 
{'template': 'my_calendar/calendar'}), 


11 修改 settings.py 安装 my_calendar 应 用 


INSTALLED_APPS = ( 
"django.contrib.auth', 
"django.contrib.contenttypes', 
"django.contrib.sessions', 
"django.contrib.sites', 
"newtest.wiki', 
"newtest.address', 
"newtest.ajax', 
"newtest.my_calendar', 
"django.contrib.admin', 


增加 了 my_calendar 应 用 。 


12 È Z) server 测试 


页 面 上 应 该 显示 出 Calendar 的 文本 。 我 们 在 模板 中 定义 的 参数 没有 被 用 到 。 因 为 我 们 没有 站 
EHA HTMLCalender 输出 ， 因 此 上 面 只 是 说 明 框 架 是 可 用 的 。 


下 面 让 我 们 加 入 参数 的 处 理 。 


13 修改 
my_calendar/templatetags/my_calendar.py 


from django import template 
import HTMLCalendar 


register = template.Library() 


class CalendarNode(template.Node): 
def nicsen year, mon): 
self.year = int(year) 
self.mon = int(mon) 


def inendems(seli,, context); 
return HTMLCalendar .MonthCal().render(self.year, self.mon) 


def do_calendar(parser, token): 
Ery: 
tag_name, arg = token.contents.split(None, 1) 
except ValueError: 
#if no args then using current date 
import datetime 
today = datetime.date.today() 
year, mon = today.year, today .mon 
else: 
GIs 
year, mon = arg.split(None, 1) 
except ValueError: 
raise template.TemplateSyntaxError, "%r tag requires year and mon argument 
s" % tag_name 


return CalendarNode(year, mon) 


register.tag('calendar', do_calendar) 


主要 改动 如 下 : 

1. 增加 了 import HTMLCalendar 的 导入 。 

2. 修改 了 calendarNode 的 _init_() 方法 ， 增 加 了 两 个 参数 。 

3. 修改 了 calendarNode 的 render() 方法 。 改 成 输出 一 个 Calendar 的 表格 。 


4. 修改 了 do_calendar() 函数 ， 增 加 了 参数 的 处 理 。 如 果 没 有 输入 参数 则 使 用 当前 的 年 、 
月 值 。 和 否则 使 用 指定 的 年 、 月 参数 。 如 果 解 析 有 误 ， 则 引发 异常 。 


不 过 在 调试 的 过 程 中 ， 的 确 有 一 些 错 误 。 象 开始 时 我 命名 为 calendar 目录 ， 结 果 造 成 与 
系统 的 calendar 模块 重 名 。 然 后 不 得 已 进行 了 改名 。 为 什么 发 现 要 导入 HTMLTemplate 
呢 ? 因为 在 处 理 时 HTMLCalender 抛 出 了 弄 常 。 但 成 功 后 我 已 经 把 这 些 调试 语句 去 掉 
了 。 而 且 发 现 这 些 错 误 Django 报告 得 有 些 简单 ， 你 可 能 不 清楚 倒 底 是 什么 错 。 因 此 最 好 
的 方法 : 一 是 在 命令 行 下 导入 试 一 下 ， 看 一 看 有 没有 导入 的 错误 。 另 外 就 是 使 用 
try..except 然后 使 用 traceback 模块 打印 异常 信息 。 


14 启动 server 测试 


你 会 看 到 : 


January 
SETATFS 
上 e 5G 7 
8 9 1011121314 
1516171819 20 21 
22 23 24 25 26 27 28 
29 30 31 


也 许 感到 不 好 看 ， 没 关系 ， 可 以 通过 CSS 进行 美化 。 当 然 ， 这 样 可 能 还 是 不 让 人 满意 ， 比 
如 : 不 是 i18n 方式 的 ， 因 此 看 不 到 中 文 。 不 过 这 已 经 不 是 我 们 的 重点 了 。 掌 握 了 自 定义 Tag 
的 方法 就 可 以 自行 进行 改造 了 。 


同时 HTMLCalender 模块 本 身 可 以 传 入 一 些 链接 ， 这 样 就 可 以 在 日 历 上 点 击 了 。 这 里 不 再 试 
验 了 。 有 关 趣 的 可 以 自己 做 一 下 。 


Django Step by Step (十 七 ) 


1 引言 


经 过 前 面 许多 讲 之 后 ， 我 想 大 家 应 该 对 Django 的 基本 开发 概念 和 过 程 已 经 有 所 了 解 。 那 么 是 
时 候 讲 一 些 关 于 设计 方面 的 东西 。 首 先 要 声明 ， 目 前 Django 基本 上 还 没有 什么 设计 的 教程 ， 
而 我 也 只 能 写 一 些 个 人 体会 。 


那么 这 篇 教程 的 体会 就 是 : View, Template and Templatetag 


2 View, Temaplte 和 Tag 之 间 的 关系 


View 在 Django 中 是 用 来 处 理 请 求 的 ， 一 个 url 请 求 上 来 后 经 过 Django 的 处 理 首先 找到 这 个 
url pattern 对 应 的 View 模块 的 某 个 方法 。 因 此 View 是 处 理 请 求 的 起 点 ， 同 时 ， 在 View 中 的 
方法 需要 返回 ， 因 此 它 还 是 一 个 请 求 的 终点 。 因 此 象 Template 和 Tag 只 不 过 是 处 理 中 的 某 些 
环节 。 View 可 处 理 的 范围 远大 于 Template 而 Tag 则 只 能 用 在 Template 中 。 因 此 从 使 用 范 

围 上 说 : View > Template > Tag ° 


Template 是 用 来 输出 内 容 的 ， 目 前 在 Django 中 你 可 以 用 它 输 出 文本 之 类 的 东西 。 但 象 图 片 
之 类 的 非 文本 的 东西 ， 则 只 能 通过 View 来 实现 ， 再 有 如 果 想 在 输出 时 加 入 一 些 特殊 的 

A 的 控制 也 只 能 在 View 中 实现 。 当 然 ， 在 大 多 数 情况 下 我 们 只 处 理 动态 的 文本 生 
成 ， 其 它 许 多 东西 都 是 静态 的 。 象 图 片 之 类 的 可 以 通过 链接 来 引用 。 


Tag 是 在 Template 中 被 使 用 的 。 它 的 作用 很 多 ， 如 控制 模板 逻辑 ， 还 可 以 输出 内 容 并 做 转换 
等 。Tag 可 以 自 定义 ， 因 此 你 可 以 在 Tag 中 做 几乎 你 想 做 的 有 关内 容 输 出 的 任何 事 ， 如 从 数 
据 库 中 取出 内 容 ， 然 后 加 工 ， 输 出 ， 许 多 事情 。 


在 Django 中 提供 了 一 种 方便 的 方法 ， 可 以 直接 将 url 与 模板 相对 应 起 来 。 但 并 不 是 说 你 不 需 
要 View 的 参与 ， 而 是 这 个 View 的 功能 是 预先 写 好 的 ， 它 的 作用 很 简单 ， 就 是 在 View 方法 
中 直接 泻 染 一 个 模板 并 输出 。 因 此 说 ， 看 上 去 好 象 是 直接 对 应 ， 但 实际 上 还 是 有 View 的 处 
理 。 上 比如 : 


(r'Aajax/$', 'django.views.generic.simple.direct_to_template', 
{'template': 'ajax/ajax.html'}), 


这 是 在 讲 Ajax 的 一 个 url 的 配置 ， 其 中 使 用 了 
django.views.generic.simple.direct_to_template 这 个 做 好 的 View 方法 。 


3 如 何 设 计 


从 上 面 的 分 析 我 们 可 以 看 出 ，View, Template, Tag 功能 不 尽 相 同 ， 但 的 确 有 部 分 功能 的 重 
司 ， 特 别 是 在 文本 信息 的 输出 。 


如 何 比较 好 的 选择 使 用 什么 来 输出 呢 ? 
可 以 从 几 下 以 方面 考虑 : 
1. 输出 内 容 
HTML 或 文本 内 容 ， 可 以 考虑 使 用 View + Template + Tag ， 其 它 的 考虑 使 用 View 
2. 输出 范围 


如 果 是 多 数据 源 ， 比 如 一 个 首页 ， 可 能 包含 许多 不 同 的 内 容 ， 如 个 人 信息 统计 ，Blog 展 
示 ， 上 日历 ， 相关 的 链接 ， 分 类 等 ， 这 些 信息 类 型 不 同 ， 如 何 比 较 好 的 处 理 呢 ? 可 以 以 
View 为 主 ， 即 数据 在 View 中 提供 ， 在 模板 中 考虑 输出 和 布局 。 但 有 一 个 问题 ， 重 用 不 
方便 。 因 此 采用 Tag 可 能 更 适合 。 因 此 对 于 单一 或 简单 数据 源 可 以 只 采用 View 和 
Template 来 实现 ， 而 对 于 多 数据 源 可 以 采用 使 用 Temaplate 控制 布局 ，Tag 用 来 输出 单 
数据 源 信息 。 


同时 对 于 多 数据 源 的 信息 还 可 以 考虑 使 用 Ajax 技术 动态 的 将 信息 结合 在 一 起 。 但 使 用 Ajax 
则 需要 动态 与 后 台 交 互 ， 将 单数 据 源 的 信息 组 织 在 一 起 ， 这 样 每 个 来 源 都 是 一 个 View 的 处 
理 。 不 过 这 个 有 些 复杂 ， 这 里 我 们 不 去 考虑 它 。 


因此 当 你 设计 结构 时 ， 首 先 考虑 实现 的 内 容 ， 是 文本 的 ， 则 可 以 考虑 使 用 View, Template 和 
Tag ° 


然后 再 看 是 否 有 重用 的 需要 ， 有 的 话 ， 将 可 重用 的 部 分 使 用 Tag 来 实现 ， 而 View 和 
Template 作 布 局 和 控制 。 


4 结论 


这 里 我 想到 一 个 问题 : 我 一 直 想 使 用 Admin 作为 我 的 数据 管理 的 界面 。 但 经 过 上 面 的 分 析 ， 
Admin 目前 大 多 数 情 况 下 只 处 理 单一 数据 表 ， 有 些 包含 关系 的 ， 比 如 一 对 一 ， 多 对 一 ， 多 对 
多 的 可 以 在 一 个 编辑 页 面 中 同时 处 理 多 个 表 的 记录 ， 但 它 还 是 有 可 能 无 法 满足 复杂 的 多 数据 
源 的 表现 和 编辑 问题 。 因 此 Admin 应 该 可 以 认为 是 一 个 缺 省 的 数据 库 管 理 界 面 ， 而 不 完全 是 
一 个 用 户 管理 界面 。 因 此 大 多 数 情况 下 ， 你 仍然 需要 自 定义 管理 界面 ， 而 不 能 完全 依靠 
Admin 。 除 非 你 的 应 用 简单 ， 同 时 对 于 管理 界面 的 要 求 不 高 。 


解决 了 这 个 问题 ， 于 是 我 们 不 必 太 留恋 Admin 的 功能 ， 我 相信 会 有 一 些 好 的 解决 方案 来 满足 
我 们 的 要 求 ， 或 者 就 是 我 们 自己 来 创建 这 样 的 项 目 。 


第 十 七 讲 View,Template 和 Tag 
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